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CHAPTER ONE 
INTRODUCTION 


1.1 INTRODUCTION 

RSX-15 is a real-time monitor system designed for handling real-time 
information in a multiprograunming environment. The modular construc- 
tion of the system allows the user to configure his availadjle hardware 
and software resources to best fit his requirements. 

RSX-15 controls and supervises all operations within the system in- 
cluding any number of core- and disk-resident programs (called Tasks) 
limited in number only by available space. This control and super- 
vision allows an unlimited number of Tasks to share core and disk 
memory, input/output device handlers, and other resources of the system. 

The execution of Tasks is determined by software priorities, hardware 
interrupts, timing algorithms, and requests from other Tasks. The 
user can install a new Task on-line, establish its software priority 
from any of 512 distinct levels, and then request its activation at 
any time with an automatic reactivation at any periodic interval of 
time thereafter. 

Utilizing simple time-directed commands, the user can dynamically 
schedule Tasks from the console terminal or from within a Task. 
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Device independence in RSX then allows the user to obtain results of 
that Task immediately on his Teletype or store them on a mass storage 
device such as a disk or magnetic tape for future reference. 

I/O requests from Tasks are queued and processed by RSX on a priority 
basis allowing high priority requests access to heavily used devices 
which have pending lower priority requests. Delays are further re- 
duced by having the actual transfer of data being performed by the 
I/O Processor independent of the Central Processing Unit, thus allow- 
ing concurrent Task execution and I/O processing. 


1.2 HARDWARE REQUIREMENTS AND OPTIONS 


The minimum hardware configuration required to operate the RSX- 15 

system on a PDP-15/35**is as follows: 

16 K of core memory 

API - Automatic Priority Interrupt 

EAE - Extended Arithmetic Element 

Real Time Clock (frequency is 16.7 msec for 60 Hz systems and 20 
msec for 50 Hz systems.) 

NOTE: The clock must be wired to API hardware level 3. 

One (1) RSi5 DECdisk (262,000 word fixed head) and one(l) RF15 
controller. 

One (1) TU56 DECtape unit and controller. 

One (1) KSR35 Teletype 
High Speed Paper Tape Reader 
High Speed Paper Tape Punch 


The RSX-15 system supports the following additional hardware: 

Addition of core memory in increments of 4K up to 32K. 

Addition of one or more disk units. The disk controller is de- 
signed to accommodate up to 8 disk units (2 million words). 

Addition of one or more DECtape units. The controller is designed 
to accommodate up to 4 TU56 DECtape units (8 tape drives). 

Addition of one or more Teletypes. Up to 16 additional Teletypes, 
either model KSR33 or KSR35, may be added to the standard 
system (under LT15/LT19) . 

One (1) VTOl storage tube display system. (Tektronix model 611 
storage tube with interface) . 

One (1) to Eight (8) TUIO - 7 or 9 track IBM compatible magtape 
transport (7 and 9 track may not be mixed) 

One (1) LP15 - Line Printer. 


Teletype is a trademark of the Teletype Corporation. 
** A fully ECOed PDP-15 is required. 
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1.3 SYSTEF! SOFTWARE 


RSX-15 is a complete system for program preparation, compilation, 
assembly, debugging, and operation in a system that has been config- 
ured to the user's needs. 

The RSX-15 system utilizes two separate monitors, the ADVANCED Soft- 
ware Monitor and the Real-Time Monitor. The ADVANCED Software Moni- 
tor is the standard monitor for the PDP-15/20 and PDP-15/35 computers. 

The ADVANCED Monitor is used in the development, debugging, and build- 
ing of executable Tasks for the Real-Time Monitor. The system soft- 
ware includes the FORTRAN IV compiler, MACRO assembler, TEXT EDITOR, 
TASK BUILDER, and numerous Utility programs*. 

The TASK BUILDER, TKB, is used to build user's Tasks from relocatable 
binary files by linking them together along with library functions to 
constitute an executable Task that runs under control of the Real- 
Time Monitor. TKB is quite similar to the CHAIN program allowing 
very elaborate overlay structures to be built. A resultant Task is 
defined by a name (Task name), default run priority, core partition 
and common block requirements, and resident code. The Task, which 
resides either on paper tape or DECtape, is now ready to be incorpo- 
rated into the real-time operating system under control of the Real- 
Time Monitor. Chapter five discusses the TASK BUILDER in greater 
detail. 

The Real-Time Monitor is used to supervise and control the execution 
of real-time Tasks. The real-time software includes the RSX-15 
EXECUTIVE, I/O Device Handler Tasks, Resident MCR, and the SYSTEM 
CONFIGURATOR. The SYSTEM CONFIGURATOR is a Task which is 
requested by the Real-Time Monitor when the system is initially loaded. 


* Refer to ADVANCED Software Monitor Manual and Utility Programs Manual. 
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The CONFIGURATOR is an interactive program which asks the user several 
questions in order to tailor the RSX-15 EXECUTIVE to suit his partic- 
ular application and hardware configuration. The user is required to 
supply information such as the amount of core memory available, number 
of disk units and Teletypes, partition sizes and locations, common 
areas, and which I/O Device-units are in the system. Chapter Six 
discusses the SYSTEM CONFIGURATOR in greater detail. 
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CHAPTER TWO 
EXECUTIVE 


2.1 INTRODUCTION 

The RSX EXECUTIVE is the heart of the real-time operating system. 

It coordinates all activities in the system including Task scheduling, 
I/O supervision, resource allocation, and interactive operator communi- 
cation. 

The core memory of the RSX system is divided into partitions that are 
occupied by the Real-Time Monitor, Monitor Console Routine (MCR) 
Function Tasks, I/O Handler Tasks, user written Tasks (programs ) , and 
COMMON Blocks used for inter-Task communications. There is no limit 
to the number of core partitions and COMMON Blocks that can be defined 
except for the amount of core space available. All Tasks are then 
executed from these partitions allowing several progrcims to be in core 
at any given time (multiprogramming) . Normally Tasks reside on 
the disk, and are brought into their partition (if unoccupied) only 
when requested, and release their partitions upon exit. However, 
when desirable, or necessary, a Task may be fixed in core, thereby 
dedicating a partition to a single Task, but assuring core availabil- 
ity and rapid response. Tasks that can tolerate a response time of 
100 milliseconds or more will normally be disk resident rather than 
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core resident. Since the Task Builder program allows a Task to con- 
sist of a resident program with a simple to very elaborate overlay 
structure, a Task can be both core and disk resident at the same time. 
The core resident program remains in core once the Task has been acti- 
vated/and overlay segments are requested when needed. Requested over- 
lay segments will be executed immediately if already in core, or 
brought in from disk overlaying the previous segment (s) and then 
executed. When a Task is built using the Task Builder program it can 
include any number of user written programs and be assigned any core 
partition (providing the partition was defined at system configuration 
time and is large enough to contain the Task) . The Task can also be 
assigned any run priority (which may be overridden at run time) from 1 
to 512 where 1 is the highest priority. 

Task execution occurs because of requests by the operator, requests 
from a currently executing Task, or by a predefined schedule*. 

Activated Tasks are defined in the system Active Task List and sched- 
uled Tasks are defined in the Clock Queue to be activated at a pre- 
defined time. Tasks can also be installed in the system on-line 
while other Tasks are currently executing. 

2.2 EXECUTIVE ORGANIZATION 
2.2.1 CORE AND DISK TOAGEfiENT 

Core memory in the RSX system is partitioned to allow several Tasks 
to be active at any given time. All core above the resident EXECUTIVE 
(first 4K) can be user specified into Partitions and COMMON Blocks 
during system configuration. All unspecified space above the first 
8K of core will then be used to create Partition Blocks and a reservoir 

* The scheduling capabilities of RSX will be described later. 
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of empty nodes called the "Pool”. Each node in the Pool consists of 
ten contiguous memory locations with internal pointers connecting the 
previous node to the next node resulting in a circular or double ended 
queue called a dequ^. The EXECUTIVE uses nodes to create linked lists 
containing system information. These nodes are removed from and re- 
turned to the Pool as needed. 

Since the Pool and Partition Blocks are needed to run, sufficient 
core above the lower 8K core should be left unspecified. Unspecified 
core below 8K (and above the EXECUTIVE) is unused. 

Partitions and SYSTEM COMMON Blocks^ are fixed at system configuration 
time and cannot be altered at run time. Tasks are built to execute in 
specific partitions, and, any number of Tasks may be built to execute 
in the same partition. 

A Partition containing an active Task cannot be used by other Tasks, 
regardless of priority, until that partition becomes available. When 
two or more requests for the same partition are made and the partition 
is occupied, the Task with the highest priority will be serviced first 
when the partition becomes available. An executing Task releases its 
partition once it EXITS to the EXECUTIVE. 

RSX uses the disk for storage of user written Tasks, MCR Function 

Tasks and data. Disk space is automatically allocated by the 

EXECUTIVE when Tasks are installed in the system. The remaining 

portions of the disk are available to the user. When a Task requires 

disk space to store data, it must request it through the EXECUTIVE 

via an ALLOCATE Directive. The actual allocation of disk space is 

performed in increments of 12 82^0 words of contiguous disk storage 

providing the user with true random access capability. The EXECUTIVE 

maintains a record of availedDle disk space by using a bit map scheme. 

A user can relinquish allocated disk space through the use of the 

^Deque is pronounced "deck". 

^See Glossary: COmON BLOCK, SYSTEM. 
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DEALLOCATE Directive, 

2.2.2 SCHEDULING OF REAL-TIME PROGRAMS (TASKS) 

The scheduling of Real-Time progreuns (Tasks) can result from any one 
of three types of events: the request for the activation of a Task, 
the request for an Input/Output transfer, or the occurrence of a 
hardware interrupt. It is important that the reader have a thorough 
understanding of the meaning of "Significant Event" ^ and the Active 
Task List in order to understand the concepts of scheduling in RSX, 

The Active Task List is a priority ordered list of Active Tasks that 
is used to drive the system. This list is scanned from high to low 
priority by the EXECUTIVE as a result of a Significant Event to give 
control to the highest priority Task that is capable of executing at 
that time . 

Tasks are installed in the system either at the priority given them 
at Task Building time (default priority) or at the priority specified 
in the INSTALL Directive. For instance, the user can install a Task 
named SCAN with default priority 100 by typing: 

INSTALL SCAN 

If a new default priority of 78 were desired, the user could have in- 
stalled SCAN by typing: 

INSTALL SCAN 78 

Task priorities can also be altered at run time either by the operator 

or by a currently executing Task, Once a Task has been installed in 

the system it can be activated by typing: 

REQUEST SCAN (Task will execute at default 

priority) 

SCHEDULE SCAN 13:50:00 30M (Task will execute at default 

priority at 1:30 P.M. and be resched- 
uled every 30 minutes thereafter) 

RUN SCAN 25M (Task will execute at default 

priority 25 minutes from now) 

^Task initiation, task completion, and I/O completion are examples of 
significant events. 
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SYNC SCAN H 30M 2H 78 (Task will be executed at priority 

78, 30 minutes past the hour, and 
every 2 hours thereafter) 

A request to activate a Task will be executed providing that a parti- 
tion is available and a Task with a higher priority is not currently 
executing. Once a Task is activated it will run to completion unless 
interrupted by a higher priority Task. An interrupted lower priority 
Task will be resumed only when higher priority Tasks have completed 
or have relinquished control. Whenever one Task is interrupted by 
another, its active registers are automatically saved by the 
EXECUTIVE and later restored when execution is resumed. Control will 
be given to a lower priority Task if a currently executing Task is 
waiting for the completion of an I/O request or by issuing any of the 
following Directives: WAIT; WAITFOR; and SUSPEND. Control can 
be given to a higher priority Task by requesting it to be run or by 
issuing any of the following Directives: REQUEST, RUN, SYNC, and 
SCHEDULE. 

The following example illustrates the mechanism used by the EXECUTIVE 
to scan the Active Task List. Assume that two Tasks are installed in 
the system with names TASKl and TASK2 and have priorities of 50 and 
100 respectively^. The operator requests TASKl to be executed one 
minute from now and TASK2 to be executed immediately. The operator's 
commands would be: 

RUN TASKl IM 
REQUEST TASK2 

The following chart describes the sequences of events during the 
request and activation of both Tasks. 

^The larger number indicates a lower priority. 
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2.2.3 INPUT/OUTPUT OPERATIONS 


The RSX EXECUTIVE allows the user device independent programming, 
reassignment of devices on-line, and the ability to queue I/O re- 
quests providing him with an extremely powerful and flexible I/O 
structure. 

The RSX system provides the user with device handlers for standard 
I/O devices supplied with the system. These handlers are called I/O 
Device Handler Tasks and can be installed in the system either at 
system configuration time or on-line. I/O Handler Tasks are connected 
to the user's environment by means of a logical/physical device re- 
lationship. This relationship allows the user to reference a Logical 
Unit Number (LUN) rather than a physical device when requesting an 
I/O operation. At run time the user then may reassign the LUN to the 
desired physical device. Thus, a Task which normally outputs data to 
LUN 4 which is currently assigned to the teleprinter can output the 
same results on a paper tape punch or line printer if the user types 
the following: 

REASSIGN 4 PP TT0 (Reassign LUN 4 to the Paper Tape 

(or) Punch from TTj?) 

REA 4 LP PP (Reassign LUN 4 to the line printer 

from the Paper Tape Punch) 

All requests to be serviced by I/O Handler Tasks are entered into a 
priority ordered queue even though the device may be busy. The 
priority of the request will be the same as the priority of the Task 
issuing the request. Once the Task has issued a request, it can 
either wait for its completion or continue executing and test at any 
time the current state of the I/O operation it requested. 

An Event Variable (software flag) may be associated with I/O requests 
and its value indicates the current status of the I/O operation. When 
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an I/O operation completes, the user's Event Variable is set accord- 
ingly and a Significant Event is declared. This causes the Active 
Task List to be scanned and control to be given to the highest prior- 
ity Task capaUale of executing. 

There are two types of I/O Device Handlers in the RSX System; The 
Standard I/O Device Handler Task and the System I/O Device Handler 
Task. The System I/O Handlers are the Disk and Multi-Teletype Handler 
Tasks which must be core resident and cannot be deleted from the 

system. Standard I/O Device Handler Tasks are those which are not 
System I/O Handlers supplied by the manufacturer or created by the user. 
When a LUN is assigned to a device, the Handler Task is requested and 
remains in core as long as the LUN is assigned to the device. 


A Task can obtain the exclusive use of an I/O Handler Task by issuing 

an ATTACH Directive. When the ATTACH Directive is accepted by the 

Handler, only requests from that Task are serviced with requests from 

other Tasks queued until a DETACH request is serviced. 

Example; ATTACH 2,EV Attach the device assigned to LUN 

2 to the currently executing Task. 
DETACH 2,EV Detach the Device. EV is the event 

variable. 

2.2.4 DYNAMIC SYSTEM PRIORITY CONTROL 

The priority structure of the RSX System includes both hardware and 
software priority levels. Hardware levels are established by the 
Automatic Priority Interrupt (API) of the PDP-15 computer and soft- 
ware levels are established by the user and controlled by the 
EXECUTIVE. There are 8 levels of API of which four are used for hard- 
ware I/O devices and four for the EXECUTIVE. API levels 4 and 6 are 
used exclusively by the EXECUTIVE and level 7 is used for Task 
execution (level 5 is currently not used). From level 7, the 
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EXECUTIVE derives its 512 Task priority levels used for Task operations. 
The following figure illustrates the hierarchy of the entire priority 
system. 


AUTOMATIC PRIORITY INTERRUPT SYSTEM 


Task Priority Levels 

Executive Priority Levels 

Hardware Levels 

Derived from API 

Exclusive use by 

Used by all 

level 7 by the 

the Executive 

I/O Devices 

Executive 



512 ^ 1 

I 



VELS 7 

6 5 4 

3 2 10 


Increasing Priority 


Figure 2.2 RSX Priority Structure 


The hardware API levels 0,1,2, and 3 are used to control I/O devices 
in the system. Each level can have as many as 8 device controllers 
connected to it allowing a total of 32 devices to be serviced by the 
API system. Each of the 32 API lines are associated to unique core 
locations which specify where program control will be transferred 
when an interrupt signal occurs on that line. 
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CHAPTER THREE 

m 

MONITOR CONSOLE ROUTINE 


3.1 INTRODUCTION 

The Monitor Console Routine (MCR) allows the user to communicate on- 
line with the system from the console teleprinter to dynamically 
adjust and modify the operation of the system through simple commands 
(functions) . The operator may obtain status information about the 
system, install or replace Tasks, request Task execution based upon 
time driven schedules, or fix a Task in core. Other MCR commands 
permit altering of logical/physical device relationships, examination 
and modification of core locations, and adjustment of the System Clock 
and Calendar. 

The MCR consists of the Resident MCR Task, which accepts the user's 
commands, and the MCR Functions, which actually carry out the indi- 
cated requests. The MCR Functions are similiar to user created Tasks 
in that they normally reside on the disk and are brought into a core 
partition when requested. Although the MCR Functions are built (with 
the Task Builder) to execute in a predefined core partition, they 
can be built to run in any partition. Execution of MCR Tasks, like 
all Tasks, is based upon partition availcibility and Task priority. 
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3.1.1 REQUESTING THE RESIDENT MCR 


The Resident MCR must be Active in order to receive requests for 
Function Tasks from the operator at the console teleprinter. To 
request the Resident MCR, type CTRL C (i.e., simultaneously depressing 
the CTRL and C keys) . When the MCR is ready to accept a command it 
will output: 

MCR> 

Con LUN 2) and wait for a command to be typed immediately to the right 
of the prompting character C>) 

3.1.2 ERROR DETECTION AND HANDLING 

Error detection is provided by the various MCR Functions and Resident 
MCR where applicable. When an error is detected, an appropriate 
message, prefixed by the name of the issuing MCR Function, is output 
to LUN 3 . 

3.1.3 COMMAND STRINGS 

When typing MCR coiranand strings the following Conventions apply: 

a. Command strings are terminated either by a Carriage RETURN 
or by an ALT MODE. If a Carriage RETURN is typed, the 
Resident MCR will be requested when the current Function is 
complete. If an ALT MODE is typed, the Resident MCR will 
not be requested at the termination of the current Function. 

b. Each element of a command string must be separated by either 
a comma ( , ) or a space (_) . 

c. If an error is discovered while typing a command string prior 
to typing a terminator, the line may be deleted as far back 
as the prompting character (>) by typing CTRL U (formed by 
simultaneously typing CTRL and U characters). A commercial 


3-2 



"at" C@) symbol is echoed informing the user that he can 
retype the command string. The RUBOUT, echoed as a 
backslash ( \ ) , may be used to delete the last character 
typed in. Every time the RUBOUT is typed, a backslash is 
echoed and a character is deleted, 
d. Any number of characters (except a comma or space) may be 

inserted between a Function name and its arguments or command 
string terminator (Carriage RETURN or ALT MODE) . This is 
useful if the user wishes to improve the readability of his 
teleprinter copy. 


3.2 SUGARY OF fICR FUNCTIONS* 


Task Ncune 
ETI[ME1 
TIM[E] 

DAT[E] 

TAS[K LIST] 

PAR [TIT IONS] 

COM [MON BLOCKS] 

DEV [ICES AND ASSIGNMENTS] 

INS [TALL] 

REM[OVE] 

REQ[UEST] 

cnu r UniTT I7l 

RUN 


Function 

Enter time and date into the system. 

Request current time from the system. 

Request current date and time from 
the system. 

Request System Task List. 

Request list of Partition definitions. 

Request list of Common Block defini- 
tions . 

Request list of LUN device assign- 
ments . 

Install a Task in the system. 

Remove a Task from the system. 

Request immediate activation of a 
Task. 




Request scheduled Task a delta time 
from now. 


* Square brackets of the form ([]) specify optional characters. 
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SYN(C] 

Schedule and synchronize the activa- 
tion of a Task. 

CAN [CEL] 

Cancel the activation of a Task. 

RES[UME] 

Resume execution of a suspended Task. 

FIX 

Fix Task in core (Task becomes core 
resident) . 

UNF(IX] 

Unfix Task in core. 

DIS[ABLE] 

Disable Task (reject future Task 
activation directives) . 

ENA[BLE] 

Enable a disabled Task. 

REA[SSIGN] 

Change LUN assignment (s) . 

SAV[E] 

Save image of core on the disk. 

OPE[N] 

Open register for excimination or 
modification. 


3.3 O FUNCTION DESCRIPTIONS 

The following paragraphs describe the form and function of the MCR 

Functions. To simplify the interpretation of the various command 

strings, the following symbols are used to represent the non-printing 

teleprinter operations: 

j = Carriage RETURN 
^ = LINE FEED 

7 = Terminator (either Carriage Return or ALT MODE) 

_ = Space 

Square brackets of the form ([]) specify optional characters and/or 
arguments. The ampersand sign (St) is used for concatenation of a 
numeric argument to an alphabetic letter. 

3.3.1 ENTER TIf€ 

The Enter Time Function is used to set the System Clock and Calendar. 

Form : ETI [ ME ] _Hr : Min ; Sec [ _Mo/Day/Yr ] V 

Variables: Hr = Hours (0-23) 

Min = Minutes (0-59) 

Sec = Seconds (0-59) 

Mo = Month (1-12) 
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Day = Day of Month (1-31) 

Yr = Year (last two digits 0 - 99 ) 

NOTE; The European form has the month and day reversed. 

Example: The time is 30 seconds past 3:45 P.M. and the date is 
March 23, 1971. 


fiCR>ETIME 15:45 :30 3/23/71 
riCR> 


3.3.2 TIME 


The Time Function outputs the time of day on LUN 3. 
Form: TIM[El7 

Example: The time is 41 seconds past 3:45 P.M. 

MCR>TIKE 

15:45:41 

MCR> 


3.3.3 DATE 

The Date Function outputs the System Calendar and the time of day on 
LUN 3. 

Form: DAT[E]V 

Example: The date is March 23, 1971 and time of day is 52 seconds 
past 3:45 P.M. 

MCR>DATE 

03/23/71 15:45:52 

3.3.^ TASK LIST 

The Task List Function outputs to LUN 3 a description of each Task 
which has been Installed in the system. The description consists of 
the following information (printed left to right, one line per Task) : 
Task Name, Partition Name, Priority (decimal) , Disk Unit Number 
(octal) , Head Track Address (octal) and Task Size (octal) , Output 
may be prematurely terminated by typing CTRL C. 
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Form: 


TAS[K LIST]V 


Example : 


!1CR>TASK LIST 


RX 

P14.S 

512 

0 

102200 

00530 


10.2 

002 

0 

101200 

00617 

DT* • • • 

10. I 

002 

0 

376600 

02261 

PR, . . . 

10,2 

002 

0 

075600 

00736 

LP. .. . 

10.2 

001 

0 

075030 

00463 

...DAT 

MCR 

002 

0 

074630 

001 76 

. . . OPE 

MCR 

002 

3 

073600 

30624 

...SAV 

MCR 

002 

0 

073200 

00214 

...REA 

MCR 

002 

0 

072000 

01040 

...DIS 

MCR 

002 

0 

371600 

00166 

. . . RAR 

MCR 

002 

0 

071400 

00166 

...UMF 

MCR 

002 

0 

071000 

0321 1 

. .. FIX 

MCR 

002 

0 

070400 

00302 

...RES 

MCR 

002 

0 

070000 

00250 

. .. CAN 

MCR 

032 

0 

067600 

00166 

. . . SYN 

MCR 

002 

0 

067230 

00377 

. . . RU N 

MCR 

032 

3 

066600 

00361 

. ..SCH 

MCR 

032 

0 

366000 

03437 

. . . REQ 

MCR 

002 

0 

065400 

00335 

. . . REM 

MCR 

002 

0 

065000 

00305 

. .. INS 

MCR 

302 

0 

063200 

01516 

...DEV 

MCR 

032 

0 

062400 

00533 

. .. COM 

MCR 

002 

0 

362030 

00263 

...PAR 

MCR 

002 

3 

061400 

00230 

. . . TAS 

MCR 

302 

0 

060600 

00406 

...TIM 

MCR 

002 

0 

060400 

00145 

. ..ETI 

MCR 

002 

n 

\u 

060300 

00350 


MCR> 


3.3.5 PARTITIONS 

The Partition Function outputs to LUN 3 a description of all core 
partitions defined in the system. The description consists of (printed 
from left to right, one line per partition) : Partition Name. Parti- 
tion Base Address (octal) . and Partition Size (octal) , Output may 
be prematurely terminated by typing CTRL C. 

Form: PAR[TITIONS] V 
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Excunple : 


:^CR>PARTITIONS 
MCR 10000 01600 

10. 1 11600 03000 

P14.6 14600 03200 

P21,0 21000 05500 

P26.5 26500 06500 

10.2 35200 01000 

P40.0 40000 15000 

'CR> 


3.3.6 COMMON BLOCKS 


The COMMON Blocks Function outputs to LUN 3 a description of all 
System COMMON Blocks defined in the system. The description consists 
of (printed from left to right, one line per COMMON Block) : COMMON 
Block Name, COMMON Block Base Address (octal) , and COMMON Block Size 
(octal). Output may be prematurely teirminated by typing CTRL C. 

Form : COM [MON_BLOCKS ] V 

Example : 


•:iCR> COMMON BLOCKS 
.XX 20000 00700 

FLAG 36200 00600 

MCR> 
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3.3.7 DEVICES AND ASSIGNfiENTS 


The Devices and Assignments Function outputs to LUN 3 a list of phys 
ical device units and the Logical Unit Numbers assigned to them. 
Output may be prematurely terminated by typing CTRL C. 

Form ; DEV [ ICES_AND_ASSIGNMENTS ] V 

Example : 


WP>DEVICE? AMD ASSIGNMENTS 
nK0 I 

TT? P,3,5,I3,1 1 

,22,23,24,S5,26,27,?,R,29,30,31 

32 

TTI 

DT0 4 

DTI 

DT2 

DT3 

DT4 

DT5 € 

DTf^ 

DT7 

po?! 7 

PP0 9 

LP0 2 

MCP> 


3.3.8 INSTALL 


The Install Function is used to input a Task into the RSX System. 

The Task to be added must be a binary file (TSK extension) produced 
by the Task Builder. TSK files are installed from LUN 5. 

Form; INS [TALL] _TSKNAM[_P] V 

Variables ;TSKNAM = Name of Task to be Installed (1-6 characters) 
P * Task priority (1 - 512) 

Examples: Install Task SCAN whose default priority defined at 
Task Building time is 48. 

MCR>INS SCANj 
(or) 

MCR>INS SCAN 10 j (SCAN is now redefined 

with a priority of 1)?) 
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3.3.9 


RE'iOVE 


The Remove Function is used to delete a Task from the RSX System. 
Form : REM [ OVE ] _TSKNAMV 

Variables : TSKNAM = Name of Task to be Removed (1-6 characters) 

Example: The Task SCAN is no longer required and it is desired 
to remove it from the System. 

MCR>REM SCANj 


3.3.10 REQUEST 


The Request Function is used to request the execution of a Task at an 
indicated software priority level. Actual Task execution depends upon 
priority and partition availability. 

Form: REQ [UEST]_TSKNAM(_Pl 7 

Variables: TSKNAM = Name of Task (1-6 characters) 

P = Task priority (1 - 512) 

Examples: Request the execution of SCAN whose default priority 
defined at Task Building or Installation time is 48. 
MCR>REQ SCANj 
(or) 

MCR>REQ SCAN 10j (SCAN is requested with 

a priority of 10 ) 


3.3.11 SCHEDULE 


The Schedule Function is used to schedule the execution of a Task at 

some time in the future, specified in time-of-day, at an indicated 

software priority level, and with periodic rescheduling. 

Form: SCH[EDULE]_TSKNAM_Hr;Min:Sec[_RI&RU] [_P]V 

Variables: TSKNAM * Name of Task (1-6 characters) 

Hr = Hours (0 - 23) 

Mir* =s Ml ( (X — 

Sec = Seconds (0 - 59) 

RI = Reschedule Interval (up to 1 day) 

RU = Reschedule Units (T=Ticks, S=Seconds, M=Minutes, 

and H=Hours) 

P Task Priority (1 - 512) 

Excunples: Schedule the execution of SCAN at 1:30 P.M. and resched- 
ule it every 30 minutes thereafter at its default 
priority. 
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MCR>SCH SCAN 13:30:00 30Mj 

Schedule the execution of SCAN at 8:30 A.M. and resched- 
ule it every 2/60th's of a second (60 cycle clock) at 
priority level 10. 

MCR>SCH SCAN 8:30:00 2T 10j 


3.3.12 RUN 


The Run Function is used to make a Task active at some future time, 

specified in delta time from now, at an indicated software priority 

and with periodic rescheduling. 

Form: RUN_TSKNAM_SI&SU [_RI&RU] [_P]V 

Variables :TSKNAM = Name of Task (1-6 characters) 

SI = Schedule Interval (up to one day) 

SU = Schedule Units (T=Ticks, S=Seconds, M=Minutes, 

and H=Hours) 

RI = Reschedule Interval (up to one day) 

RU = Reschedule Units (T=Ticks, S=Seconds, M= 

Minutes , and H=Hours ) 

P = Task Priority (1 - 512) 

Examples: Schedule the execution of SCAN 30 minutes from now and 
reschedule it every hour thereafter. 

MCR>RUN SCAN 30M IHj 

Schedule the execution of SCAN 10 minutes from now and 
reschedule it every 32 seconds thereafter at priority 
level 28. 

MCR>RUN SCAN 10M 32S 28j 


3.3.13 SYNCHRONIZE 

The Sync Function is used to activate a Task at some future time 
following the occurrence of the next tick, second, minute, or hour. 
The Task is executed at the indicated software priority and with 
periodic rescheduling. This Function is particularly useful for 
minimizing the peak loading of a system which can occur when many 
Tasks are scheduled for execution at the same time. 

Form: SYN[C]_TSKNAM_SZ_SI&SUI_RI&RU] [_P]V 

Variables :TSKNAM = Name of Task (1 to 6 characters) 
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SZ = Synchronization Units (T=Ticks, S=Seconds, M= 
Minutes, and H=Hours) 

SI = Schedule Interval from Synchronization time 
(up to one day) 

SU = Schedule Units (T*Ticks, S=Seconds, M=Minutes, 
and H=Hours) 

RI Reschedule Interval (up to one day) 

RU = Reschedule Units (T=Ticks, S=Seconds, M=Minutes, 
and H»Hours) 

P * Task Priority (1 - 512) 

Example: Schedule the execution of SCAN 3 minutes after the next 
hour and reschedule it every hour thereafter at its 
default priority level. 

MCR>SYN SCAN H 3M IHj 

Schedule the execution of SCAN 10 seconds after the next 
minute and reschedule it every hour thereafter at prior- 
ity 21. 

MCR>SYN SCAN M 10S IH 21 j 


3.3.1A CANCEL 

The Cancel Function is used to cancel all scheduled requests for 
activation of a particular Task by removing those requests from the 
Clock Queue. Cancellation does not affect the current execution of 
the given Task nor does it affect schedule requests made in the 
future. The latter case is covered by the DISABLE Function. However, 
schedule requests which have already been made (and entered in the 
Clock Queue) are discarded. 

Form: CAN [CEL] _TSKNAMV 

Variables :TSKNAM = Name of Task (1-6 characters) 

Example: Cancel the activation of Task SCAN. 

MCR>CAN SCANj 


3.3.15 RESUME 

The Resume Function is used to resume the execution of a Task which 
has been SUSPEND 'ed. 

Form: RES [UME]_TSKNAM f Resumption address]? 
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Variables :TSKNAM = Name of Task (1-6 characters) 

Example: Task SCAN has been previously SUSPEND 'ed and it is 
desired to resume its execution. 

MCR>RES SCANj 

3.3.16 FIX IN CORE 

The Fix Function is used to fix an inactive Task into a free partition. 
This dedicates a partition to a Task and provides for a faster response 
to the REQUEST, SCHEDULE, RUN, and SYNC Directives as well as responses 
to external interrupts. 

Form: FIX_TSKNAMV 

Variables :TSKNAM = Neune of Task (1-6 characters) 

Example: Fix Task SCAN in core. 

MCR>FIX SCANj 

3.3.17 UNFIX FROM CORE 

The Unfix Function is used to nullify a FIX Directive. If a Fixed 
Task is active when an UNFIX Directive is issued, the partition will 
be freed when the Task EXITS. 

Form : UNF ( IX ] _TSKNAMV 

Variables :TSKNAM = Neune of Task (1-6 characters) 

Example: Unfix Task SCAN from its partition. 

MCR>UNF SCANj 


3.3.18 DISABLE 

The Disable Function is used to instruct the system to reject further 
REQUEST, SCHEDULE, RUN, or SYNC Directives or periodic rescheduling 
for an indicated Task. This Function renders the specified Task in- 
capable of responding to other Directives except ENABLE. A Disabled 
Task is not deleted from the system. (cf. REMOVE.) 
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Form : DIS [ABLE ] _TSKNAMV 

Variables :TSKNAM = Name of Task (1-6 characters) 
Example: Disable the Task SCAN. 

MCR>DIS SCANj 


3.3.19 ENABLE 

The Enable Function is used to re-enable a DISABLEd Task. 

Form : ENA [ BLE ] _TSKNAMV 

Variables iTSKNAM = Name of Task (1-6 characters) 

Example: Task SCAN has been previously DISABLEd and it is desired 

to re-enable it. 

MCR>ENA SCANj 


3.3.20 REASSIGN 


The Reassign Function is used to alter the logical/physical device 

relationships by deassigning a Logical Unit Number (LUN) from a device 

and reassigning it to another device. This Function causes the 

REQUESTing and EXITing of I/O Device Handler Tasks. 

Form: REA[SSIGN]_LUN_ND_OD(/LUN_ND_OD] [/LUN_ND_0D3 ... .V 

Variables: LUN = Logical Unit Number to be Reassigned 

ND = Device to which the LUN is to be assigned 
OD = Device from which the LUN is to be deassigned. 

Examples: Assxime the following LUN assignments currently exist: 

LUN 2=TT0, LUN 3ETT)?, LUN 4SDT5, and LUN 33=LP. It is 
now desired to reassign those LUN's to the following 
devices: LUN 2=TTl, LUN 35TT1, LUN 4EDT7, and LUN 335TT0. 

MCR>REA 3 TTl TT0 j 
MCR>REA 2 TTl TT0j 
MCR>REA 4 DT7 DT5 j 
i*''‘iCR>REA 33 TT0 LFj 
(or) 

MCR>REA 2 TTl TT/3 TTl TTj 
MCR>REA 4 DT7 DT5/33 TT LPj 

Note: The MCR Functions, including the REASSIGN Function, 
use LUN's 2 and 3 for command input and output, 
respectively. Therefore, it is recommended when 
the user REASSIGN 's these to another device, he 
should do so by REASSIGNing both LUN's on the Scune 
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line as shown in the second set of examples. The 
first set of examples are valid when altering 
LUN's 2 and 3 because the output from the REASSIGN 
Function Task was altered first and further com- 
mands can still be input from LUN 2. Device names 
associated with I/O Handler Tasks provided with 
the system are: 

TT[n3 = Teletype (n is the unit number which, if omitted, 
will be assumed zero) 

DT[n] = DECtape 

DK = DECdisk 

PR = High Speed Paper Tape Reader 

PP = High Speed Paper Tape Punch 

LP = Line Printer 

3.3.21 SAVE 

The Save Function is used to record a core image of an RSX System 
(from location 30 q to the top of core memory) at the beginning of disk 
zero. The purpose of this Function is to provide a means for updating 
the system after Tasks have been added or deleted. The updated system 
can then be restored at any time by simply loading the RSX Bootstrap. 
This Function should only be executed when the system is quiescent, 
i.e-, no Tasks should be active and no I/O should be in progress? 

Since the entire RSX system is recorded on the disk, when the user 
reloads the system, the System Calendar and clock will reflect the 
previous settings at the time the Save was done. Therefore the user 
should reset them to the correct date and time after reloading the 
system. 

Form: SAV(E]7 

Excoaple; Save a copy of the RSX system on disk zero. 

MCR>SAV[E] j 

3.3.22 OPEN REGISTER 

The Open Register Function permits the user to access any core location 
for the purpose of examination and/or modification. The user may 
optionally enter a signed number in any opened location using either 

^The former does not imply the latter. 
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octal or decimal notation. Furthermore he may open and examine the 
register whose address is specified by the low order 15 bits of the 
currently open register or he may continue examination either in 
ascending or descending address order. 

Form : OPE [ N ] _ADR [ Dn] V 

Variables : ADR = Address of location to be examined. If 

the specified address is valid, the address and 
contents of that register are output followed by 
the prompting character (>)« 

D = The letter "D" signifies a disk address (ADR) 
rather than a core address to open, 
n = Disk unit nimber. 

Note: User's response follows the prompting character 
(>). The (|) symbol denotes "EXCLUSIVE OR". 

Form: ADDRESS/CONTSNTS> [new contents] } [*7] { [tV] | V 

Variables : new contents = A number (1-6 digits) which is to re- 
place the contents of the currently opened 
register. The number may be optionally 
signed (+ or -) and/or a radix operator 
(D = decimal, 0 = octal). 

EXAMPLES: Decimal -39 

-D39 (or) -D000039 

Octal 32 

032 (or) +032 (or) 32 

Terminators and special characters may be any of the 
following: 

j - Close the current register and open the 

next higher register. 

ALT MODE - Close the current register and terminate 
the Function. 

+j - Close the current register and open the 

next lower register. 

*j - Close the current register and open the 

register specified by the lower 15 bits 
of the current register. 


Example; Comments follow the slash character and are used only to 
describe the different operations. 


MCR>0PE 242j 
>00242/002325j 
>00243 /005432 *j 
> 03432/000050 000047j 

>03433/000432 -D10(ALT MODE) 


MCR>0PE 243j 
>00243/003432 + j 
>00242/002325 -6 (ALT MODE) 
MCR> 


/open register 242 
/open register 243 
/open register 3432 
/change contents of 
/ 3432 to 47. 

/change contents of 
/ 3433 to -10 decimal 

/ and terminate 
/ sequence . 

/open register 243 
/open register 242 
/change contents to -6 
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CHAPTER FOUR 
RSX SYSTEM DIRECTIVES 


4.1 INTRODUCTION 

Communication to the RSX System from the user is accomplished by the 
use of system "Directives". Directives may be issued from within a 
Task or indirectly by an operator via the teleprinter and the Monitor 
Console Routine (MCR) . The manner in which a Directive may be issued 
varies according to its function and use. 

Directive routines are structured to be reentrant and may be used to 
direct the Executive to schedule and reschedule a Task, provide status 
information for a Task, or queue I/O Handler Tasks to perform indicat- 
ed I/O operations. 


4.2 SUMMARY OF RSX DIRECTIVES & SYSTEM MACROS 


RSX DIRECTIVES 


CAL FUNCTION 

MACRO 

FORTRAN 

SYSTEM DIRECTIVE 

CODE (octal) 

CALL 

CALL 


01 

REQUEST 

REQST 

Request Task execution 

02 

SCHEDULE 

SCHED 

Schedule Task execution 

03 

RUN 

RUN 

Run Task in delta time 

14 

SYNC 

SYNC 

Sync Task execution 

04 

CANCEL 

CANCEL 

Cancel scheduled requests 

06 

SUSPEND 

SUSPND 

Suspend Task execution 

07 

RESUME 

RESUME 

Resume Task execution 
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13 

MARK 

MARK 

20 

WAITFOR 

WAITFR 

05 

WAIT 

WAIT 

10 

EXIT 

EXIT 

11 

CONNECT 

— 

12 

DISCONNECT 

— 

00 

READ 

READ 

00 

WRITE 

WRITE 

00 

DSKAL 

DSKAL 

00 

DSKDAL 

DSKDAL 

00 

DSKPUT 

DSKPUT 

00 

DSKGET 

DSKGET 

00 

ATTACH 

ATTACH 

00 

DETACH 

DETACH 

00 

SEEK 

SEEK 

00 

ENTER 

ENTER 

00 

DELETE 

DELETE 

00 

CLOSE 

CLOSE 

00 

HINF 

HINF 

21 

DISABLE 

DISABL 

22 

ENABLE 

ENABLE 

15 

FIX 

FIX 

16 

UNFIX 

UNFIX 



SYSTEM 

MACRO 

FORTRAN 

CALL 

CALL 

DECLAR 

DECLAR 

TIME 

TIME 

DATE 

DATE 

INTENTRY 

— 

INTEXIT 



4.3 DESCRIPTION OF DIRECTIVES 


Set Event Variable in delta 
time 

Wait for an Event Variable to 
be set 

Wait for next Significant 
Event 

Terminate execution of the Task 

Connect to interrupt line 

Disconnect from interrupt line 

Read from I/O Handler Task 

Write to I/O Handler Task 

Allocate disk storage 

Deallocate disk storage 

Put data on disk 

Get data from disk 

Attach Device-Unit to a Task 

Detach Device-Unit from a Task 

Seek file 

Enter file 

Delete file 

Close file 

Handler information 

Disable Task 

Enable Task 

Fix Task in core 

Unfix Task in core 


MACROS 

SYSTEM FUNCTION 


Declare a Significant Event 
Obtain Time from Executive 
Obtain Time and Date from 
Executive 

Interrupt Entry (register save 
routine) 

Interrupt Exit (register restore 
routine) 


The RSX Directives are implemented as CAL instructions* which point 
to argument blocks (CAL Parameter Blocks). As a convenience to the 
assembly language programmer, the Directives have been defined as 
macro instructions and are commonly referred to as System Macros. 

FORTRAN Tasks use Directives through standard CALL statements to a 
group of FORTRAN Library Routines which themselves issue the Directives. 

* See Glossary 
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The RSX System allows Task names of one to six characters in length, 
however, not more than five characters may be used in Task names in 
FORTRAN calls in order to comply with PDP-15 FORTRAN conventions. 

Most Macro and FORTRAN calls to RSX Directives include the Task 
priority and its Event Variable (EV) . The Task priority is indicated 
by a decimal number between 1 (highest priority) and 512 (lowest pri- 
ority) . A priority value of zero instructs the Executive that the 
Task's default priority is to be used. Directives usually have EV's 
associated with them which provide information concerning the results 
after the issuance of the Directive. If an EV is not specified 
when issuing a Directive, the Executive does not attempt to provide 
any information concerning the operation. Event Variables are set 
positive upon successful completion, zero when the request is pending, 
and negative to indicate rejection or failure. Appendix D provides 
a complete list and explanation of the EV values returned by the 
system. 

In the following sections which describe the Directives , square brackets 
of the form ([]) are used to specify optional arguments. 

4.3.1 REQUEST ^ 

This Directive instructs the Executive to initiate the execution of a 
Task based on an indicated software priority. The actual execution 
depends upon the priority and partition availability. The Event Var- 
iable, or the Event Variable and priority, may be omitted, A Task 
cannot request itself. REQUEST may be issued from an interrupt service 
routine. Event Variables returned are: +1, - 201 , - 202 , - 204 , and - 111 , 

SYSTEM MACRO : REQUEST_TSKNAM [ , P [ , EV] ] 

Variables: TSKNAM = Name of Task (1-6 characters) 

P = Task Priority (1 -512) 

EV = Event Variable Address 
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Examples: Request the execution of SCAN whose default priority 
is 48 . 

REQUEST SCAN,0,EV 
(or) 

REQUEST SCAN, 48, EV 

Request the execution of SCAN at a priority of 20 . 

REQUEST SCAN, 20, EV 
(or) 

REQUEST SCAN, 20 /In this case the testing of the 

/Event Variable is not desired. 

FORTRAN CALL : CALL_REQST (nHTSKNAM , IP [ , lEV] ) 

Variables : n = Number of characters in Task Name 

TSKNAM = Name of Task (1 -■ 5 characters) 

IP = Task Priority (1 - 512) May be either a 
Variable name or a direct constant. 
lEV = Event Variable 

Examples: Request the execution of SCAN whose default priority is 
48. 


CALL REQST (4HSCAN, 0, I EV) 

(or) 

IP=48 

CALL REQST C4HSCAN, I P, I EV) 

Request the execution of SCAN at default priority and 
no Event Variable is desired. 

CALL REQST (4HSCAN,0) 


i).3.2 SCHEDULE 

This Directive instructs the Executive to initiate the execution of a 
Task at an absolute time of day and to reactivate it continuously at 
a specified interval thereafter based on the indicated priority. If 
the Reschedule Interval is zero, the Task is executed only once at the 
time of day specified. A Task may SCHEDULE itself, however, the 
SCHEDULE Directive may not be issued from an interrupt service routine. 
Event Variables returned are: +1, -201, -203, -204, and -777. 

SYSTEM MACRO: SCHEDULE_TSKNAM,SH,SM,SSr ,RIfRUl ,Pr ,EVj ] ] 

Variables: TSKNAM = Name of Task (1-6 characters) 

SH = Schedule Hour (0 - 23) 

SM = Schedule Minute (0 - 59) 
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SS = Schedule Second (0 - 59) 

RI = Reschedule Interval (up to one day) 

RU = Reschedule Units (l=Ticks, 2=Seconds, 

3=Minutes, and 4=Hours) 

P = Task Priority (1 - 512) 

EV = Event Variable Address 

Excimples: Schedule Task SCAN to run at 4:30 P.M. and every 5 irin- 
utes thereafter at a priority of 200 , 

SCHEDULE SCAN, 16, 30, 0,5, 3^200, EV 
(or) 

SCHEDULE SCAN, 16, 30, 0,5, 3 /If Task's default 

/priority was 200 and 
/Event Variable was 
/not desired. 

Schedule Task ALPHA to run at its default priority at 
7:15 A.M. with no rescheduling and no Event Variable. 

SCHEDULE ALPHA, 7, 15 


FORTRAN CALL : CALL_SCHED (nHTSKNAM, IT , IP [ , lEV] ) 

Variables: n = Number of characters in Task Name 

TSKNAM = Name of Task (1-5 characters) 

IT = Name of 5 word (integer) array to describe 
the time of scheduling and rescheduling. 
The array is described below: 

IT(1) = Schedule Hour (0 - 23) 

IT (2) = Schedule Minute (0 - 59) 

IT (3) = Schedule Second (0 • 59) 

IT (4) = Reschedule Interval (up to one 
day) 

IT (5) = Reschedule Units (l=Ticks, 
2=Seconds, 3=Minutes, and 
4=Hours) 

IP = Task Priority (1 - 512) 

lEV = Event Variable 

Examples: This example is equivalent to the first example in this 
section using FORTRAN. 

DIMENSION ITC5) 

IT(l) = 16 
IT(2) = 30 
IT(3) = 0 
IT(4) = 5 
IT(5) = 3 
IP = 200 
lEV =0 

CALL SCHED(4HSCAN, IT, IP,IEV) 

(or) 

CALL SCHED(4HSCAN,IT,200, lEV) 

Schedule SCAN as above with no Event Variable and at its 
default priority. 

IP = 0 

CALL SCHED(4HSCAN, IT, IP) 
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To schedule SCAN only once, set the reschedule interval 
equal to zero. 


ITC4) = 0 
IP =0 

CALL SCHED(4HSCAN, IT, IP) 


^.3.3 RUN 


This Directive instructs the Executive to initiate the execution of a 
Task at a specified time interval from the time that the Directive is 
issued and reactivate the Task continuously at a specified interval 
thereafter. If the Reschedule Interval is zero, the Task is executed 
only once. A Task may use this Directive to reschedule itself, but 
the Directive may not be issued from an interrupt service routine. 
Event Variables returned are: +1, -201, -203, -204, and -777. 


SYSTEM MACRO : RUN_TSKNAM , SD , SU[ , RI , RU [ , P { , EV] ] ] 

Variables: TSKNAM = Name of Task (1-6 characters) 

SD = Schedule Delta time from now (up to one 
day) 

SU = Delta Units (l=Ticks, 2=Seconds, 3=Minutes, 
and 4=Hours ) 

RI = Reschedule Interval (up to one day) 

RU = Reschedule Units (l=Ticks, 2=Seconds, 

3=Minutes, and 4=Hours) 

P = Task Priority (1 - 512) 

EV = Event Variable Address 

Examples: Run the Task INITS 5 seconds from now and every 10 
minutes thereafter at priority of 512. 

RUN INITS, 5, 2, 10, 3,512, EV 

Run the same Task at its default priority with no 
Event Variable specified. 

RUN INITS, 5, 2, 10,3 

FORTRAN CALL : CALL_RUN (nHTSKNAM , IT , IP [ , lEV] ) 

Variables: n = Number of characters in Task Name 

TSKNAM = Name of Task (1-5 characters) 

IT = Name of 4 word (integer) array to describe 
the time of scheduling and rescheduling. 

The array is described below: 

IT(1) = Schedule Delta time from now 
(up to one day) 
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IT (2) = Delta Schedule Units (l=Ticks, 
2=Seconds , 3=Minutes , and 
4=Hours) 

IT (3) = Reschedule Interval (up to one 
day) 

IT (4) = Reschedule Units (l=Ticks, 
2=Seconds , 3=Minutes , and 
4=Hours) 

IP = Task Priority (1 - 512) 

lEV = Event Variable 

Example: Run the Task INITS 5 seconds from now and every Ij? 

minutes thereafter at a priority of 512. 

DIMENSION IT(4) 

ITCl) = 5 
IT(2) = 2 
IT(3) = 10 
IT(4) = 3 
IP =512 

CALL RUNC5HINITS, IT, IP, lEV) 


^.3.^1 SYNC 


This Directive causes the Executive to execute a Task at a specified 
interval after the next hour, minute, second, or tick and to reinitiate 
the Task continuously at a specified interval. 


A Schedule Delta Time value of zero causes the named Task to be start- 
ed on the next occurrence of the Synchronization Unit. A Reschedule 
Interval of zero causes the Task to be executed only once. This Di- 
rective may not be issued from an interrupt service routine. A Task 
may use SYNC to reschedule itself. Event Variables returned are: +1, 
-201, -203, -204, and -777'. 


SYSTEM MACRO : S YNC_TSKNAM , S Z , SD , SU { , RI , RU I , P I , EV] ] ] 

Variables: TSKNAM = Name of Task (1-6 characters) 

SZ = Synchronization Units (l=Ticks, 2=Seconds, 
3=Minutes, and 4=Hours) 

SD = Schedule Interval from synchronization 
time (up to one day) 

SU = Schedule Units (l=Ticks, 2=Seconds, 
3=Minutes, and 4=Hours) 
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RI = Reschedule Interval (up to one day) 

RU = Reschedule Units (l=Ticks, 2=Seconds, 

3=Minutes, and 4=Hours) 

P = Task Priority (1 - 512) 

EV = Event Variable Address 

Examples: Assuming the time is now 14:27:47, run Task FRED at 
14:28:09 at a priority of 20 and reschedule it every 
4 minutes thereafter. 

SYNC FRED,3,9,2,4,3,20,SYNEV 

Schedule the execution of SCAN 10 seconds after the next 
minute mark and reschedule it every hour thereafter at 
priority 21. 

SYNC SCAN,3,10,2,1,4,21,SYNEV 

FORTRAN CALL : CALL_SYNC (nHTSKNAM , IT , IP [ , lEV] ) 

Variables: n = Number of characters in Task Name 

TSKNAM = Ncime of Task (1-5 characters) 

IT = Name of 5 word (integer) array to describe 
the time of synchronization, scheduling, 
and rescheduling. The array is described 
below: 

IT(1) = Synchronization Units (l=Ticks, 
2=Seconds, 3=Minutes and 
4=Hours) 

IT (2) = Schedule Interval from synchro- 
nization time (up to one day) 

IT (3) = Schedule Units (l=Ticks, 
2=Seconds , 3=Minutes , and 
4=Hours) 

IT (4) = Reschedule Interval (up to one 
day) 

IT (5) = Reschedule Units (l=Tieks, 
2=Seconds, 3=Minutes, and 
4=Hours) 

IP = Task Priority (1 - 512) 

lEV = Event Variable 

Examples : Schedule the execution of Tasks FRED and SCAN as 
described in the examples for the System Macros. 

INTEGER FREDEV,SCANEV,SCANP,FREDP 
DIMENSION IT(5) 

IT(l) = 3 
IT(2) = 9 
IT(3) = 2 
IT(4) = 4 
ITC5) = 3 
FREDEV = 0 
FREDP = 20 

CALL SYNC(4HFRED, IT, FREDP, FREDEV) 

SCANEV = 0 
SCANP =21 
ITC2) = 10 
ITC4) = 1 
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ITC5) = 4 

12 CALL SYNC(4HSCAN, IT,SCANP,SCANEV) 

C INSURE BOTH SYNC REQUESTS WERE ACCEPTED 

IF(SCANEV.OR.FREDEV.LT.0) GO TO 10 
C BOTH SYNC REQUESTS WERE ACCEPTED AT THIS POINT 


C REPORT FAILURE OF SYNC REQUESTS TO BE ACCEPTED TO 

CONSOLE OPERATOR. 

10 WRITE(5,lO 

11 FORMAT(32H TASKS FRED OR SCAN NOT SYNCED.//) 

STOP 

END 


i|.3.5 CANCEL 


This Directive instructs the Executive to remove all entries which 
appear in the Clock Queue for a specified Task. Cancel may not be 
issued from an interrupt service routine and has no effect on an 
active Task. Event Variables returned are: +1 and -201. 


SYSTEM MACRO: CANCEL_TSKNAM [ , EV] 

Variables: TSKNAM = Name of Task (1-6 characters) 

EV = Event Variable Address 

Example: Cancel the activation of Task SCAN. 

CANCEL SCAN^EV 

FORTRAN CALL : CALL_CANCEL (nHTSKNAM [ , lEV] ) 

Variables: n = Number of characters in Task Name 

TSKNAM = Name of Task (1-5 characters) 
lEV = Event Variable 

Example: Cancel the activation of Task SCAN 

CALL CANCELC4HSCAN, lEV) 


A. 3. 6 SUSPEND 

This Directive instructs the Executive to suspend execution of the 
Task issuing this Directive, The Task remains active in its core 
partition but execution is not permitted until the system receives a 
RESUME Directive, The Executive ignores this Directive if it is 
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issued from an interrupt service routine. 

SYSTEM MACRO : SUSPEND 
FORTRAN CALL: CALL SUSPND 

A. 3. 7 RESUME 

This Directive instructs the Executive to resume execution of a Task 
which has been SUSPENDed. Task execution continues either at a spec- 
ified Resumption Address or, if not specified, at the address immediate- 
ly following the SUSPEND Directive. Event Variables returned are: +1, 
-202, and -205. 

SYSTEM MACRO : RESUME_TSKNAM [ , RA [ , EV] ] 

Variables: TSKNAM = Name of Task (1-6 characters) 

RA = Resumption Address (octal) 

EV = Event Variable Address 

Example: Resume Task TSKA at location RSTRT. 

RESUME TSKA^RSTRT,EVA 

FORTRAN CALL : CALL_RESUME (nHTSKNAM [ , lEV] ) 

Variables : n = Number of characters in Task Name 

TSKNAM = Name of Task (1-5 characters) 

lEV = Event Variable 

Example: Resume Task TSKA. 

CALL RESUMEC4HTSKA, lEV) 

Note: The RESUME subroutine permits a SUSPENDed Task 
to resume only at the location immediately 
following the CALL SUSPND statement. 

^.3.8 MARK 

This Directive instructs the Executive to clear a specified Event 
Variable and set it to a non-zero value after a specified time inter- 
val has elapsed. If the request is accepted, the Event Variable is 
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cleared. After the specified interval has elapsed, the Event Varia- 
ble is set to +1 and a Significant Event is declared. The user may 
test the Event Variable as desired. The time interval indicates time 
from the execution of the Directive. The Mark Directive is ignored 
if issued from an interrupt service routine. Event Variables returned 
are: +1, - 203 , and - 111 , 


SYSTEM MACRO: MARK_MI ,MU ,EV 

Variables : MI = Delta Interval (up to one day) 

MU = Delta Units (l=TickSf 2=Seconds, 3=Minutes, 

and 4=Hours) 

EV = Event Variable Address 

Example: Set Event Variable TSTEV 5 minutes from now. 

MARK 5, 3, TSTEV 

FORTRAN CALL : CALLJ-IARK ( IT , lEV ) 

Variables: IT = Name of 2 word (integer) array to describe 

the time. The array is described below: 
IT(1) = Delta Interval (up to one day) 

IT (2) = Delta Units (l=Ticks, 2=Seconds, 
3=Minutes, and 4=Hours) 
lEV = Event Variable 

Example: Same as above example except in FORTRAN. 

DIMENSION IT(2) 

IT(l) = 5 
IT(2) = 3 
CALL MARKCIT, lEV) 


4.3.9 WAITFOR 

This Directive instructs the Executive to examine a specified Event 
Variable and, if zero, suspend execution of the issuing Task until 
the Event Variable is found to be non— zero* The Event Variable is 
examined at each occurrence of a Significant Event. Once a non-zero 
value is detected, the suspended Task is resumed (contingent on pri- 
ority) at the address immediately following the Directive (CAL) . If 
WAITFOR is issued from an interrupt service routine, it will be ignored. 
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SYSTEM MACRO: WAITFOR_EV 

Variables: EV = Event Variable Address 

Example: In this example, the Mark Directive requests that an 

Event Variable (MRKEV) be zeroed for 5 minutes and then 
set non-zero. The WAITFOR detects the fact that the 
Event Variable is zero and suspends Task execution un- 
til the value becomes non-zero (i.e., in 5 minutes). 

The Task is then resumed at the instruction immediately 
following the WAITFOR. 

MARK 5, 3, MRKEV 
WAITFOR MRKEV 

FORTRAN CALL: CALL_WAITFR (lEV) 

Variables : lEV = Event Variable 

Example: Same as preceding example except in FORTRAN. 

DIMENSION IT(2) 

ITCO = 5 
IT(2) = 3 

C lEV WILL AUTOMATICALLY BE CLEARED BY MARK 

CALL MARKCIT,IEV) 

CALL WAITFR(IEV) 


il.3.10 WAIT 


This Directive instructs the Executive to suspend execution of the 
issuing Task until the next Significant Event occurs. The Task is re- 
sumed (contingent upon priority) at the next Significant Event and con- 
tinues at the location immediately following the WAIT. It is the 
responsibility of the Task issuing the WAIT to determine the meaningful- 
ness of the Significant Event which caused it to be resumed. This 
Directive is ignored if issued from an interrupt service routine. 


SYSTEM MACRO : WAIT 
FORTRAN CALL: CALL_WAIT 

4.3.11 EXIT 

This Directive causes the Executive to terminate execution of the 
issuing Task. If the issuing Task is not fixed-in-core (via FIX) the 
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core partition occupied by the Task becomes available to other Tasks. 
This Directive should not be issued until all transfers to the par- 
tition (e.g. I/O transfers, Task-to-Task transfers. Event Variable 
settings, etc.) have been completed. This Directive is ignored if 
issued from an interrupt service routine. 


SYSTEM MACRO: EXIT 
FORTRAN CALL: CALL_EXIT 

^1.3.12 CONNECT 

This Directive instructs the Executive to create a linkage between a 
specified API (Automatic Priority Interrupt) trap address and a spe- 
cified entry point to an interrupt service routine (there is one trap 
address for each of the 32 API lines in the PDP-15) . Event Variables 
returned are: +1, -3j2fl, and - 3 ^ 2 , The following is a list of API 
line assignments 


LINE NUMBER 

DEVICE 

LINE NUMBER DEVICE 

04 

DECtape 

24 

Diskpack 

05 

Magtape 

25 

Plotter 

06 

(unused) 

26 

(unused) 

07 

(unused) 

27 

(unused) 

10 

Paper Tape Reader 

30 

(unused) 

11 

*Clock 

31 

UDC15 

12 

Power Failure 

32 

AFC 15 

13 

Memory Parity 

33 

(unused) 

14 

VP15 Display 

34 

*LT15/LT19 Printers 

15 

Card Reader 

35 

*LT15/LT19 Keyboards 

16 

Line Printer 

36 

DECtape (additional) 

17 

A/D Converter 

37 

Dataphone (additional) 

20 

Interprocessor Buffer 

40 

*Console TTY (Key- 
board) 

21 

(unused) 

41 

*Console TTY (Print- 
er) 

22 

Dataphone 

42 

Paper Tape Punch 

23 

*Disk 

43 

Memory Protect 


*These lines are always connected to the system. 


4-13 



SYSTEM MACRO: CONNECT LN,CL[,EV] 


Variables: LN = Interrupt line Number (octal) 

CL = Entry Address of interrupt service routine 
EV = Event Variable Address 


Example: Connect an interrupt service routine for an A/D Converter 

(entry point called ADINT) to interrupt line 31. 

CONNECT 31, ADINT, ADEV 

FORTRAN CALL: No subroutine is provided for this Directive since 
FORTRAN is not an appropriate language for writing 
interrupt handling routines. 


^1.3,13 DISCONNECT 

This Directive instructs the Executive to remove the linkage created 
between an Automatic Priority Interrupt trap address and an interrupt 
service routine entry by the CONNECT Directive. Event Variables 
returned are: +1, -3j2fl, and -3jaf2. 


SYSTEM MACRO ; DISCONNECT_LN , CL , EV 

Variables: LN = Interrupt Line Number (octal) 

CL = Entry Address of interrupt service routine 
EV = Event Variable Address 

Example: Disconnect the A/D Converter from interrupt line 31. 

DISCONNECT 3 1 , ADINT, ADEV 

FORTRAN CALL: No subroutine is provided for this Directive since 
FORTRAN is not an appropriate language for writing 
interrupt handling routines. 

4.3.14 READ 

READ generates a form of the QUEUE I/O Directive which causes input 
of formatted ASCII or Binary to a specified buffer via the I/O Device 
Handler Task assigned to the indicated Logical Unit Number. The 
Event Variable specified is set to zero when the request is accepted 
and subsequently is set to an appropriate value indicating the status 
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of the operation. Event Variables returned are: + 2 , +1, -5, -7, -11, 
- 12 , - 16 , - 23 , - 101 , - 102 , - 103 , and -777. 


SYSTEM MACRO: READ_LUN,MODE,BUFF,SIZE [ ,EV] 

Variables: LUN = Logical Unit Number (decimal) 

MODE = I/O Data Mode (0=IOPS BINARY, 1=IMAGE 

BINARY, 2=I0PS ASCII, and 3=IMAGE ASCII) 

BUFF = Starting Address of user's buffer 

SIZE = Maximum number of words to transfer (octal) 

EV = Event Variable Address 

Example: Read 256 (decimal) words in lOPS ASCII from the device 

assigned to LUN 3 and store them in a buffer called TXTBF. 

READ 3,2,TXTBF, 402, INDEV 
CO A rT'Ptoft. tfcJbEV 

FORTRAN CALL: No subroutine is necessary to implement this Direc- 
tive. The standard READ statement as described in 
the PDP-15 FORTRAN IV Manual is used. 

Example: DIMENSION TXTBF(256) 

READ (3,10) TXTBF 
10 F0RMAT(256A1) 


4.3.15 WRITE 


WRITE generates a form of the QUEUE I/O Directive which causes output 
of formatted ASCII or Binary from a specified buffer to the I/O Device 
Handler Task assigned to the indicated Logical Unit Number. The Event 
Variable specified is set to zero when the request is accepted and 
subsequently set to an appropriate value indicating the status of the 
operation. Event Variables returned are: +2, +1, -6, -7, -11, -12, 
-15, -16, -23, -lj2fl, - 102 , - 103 , and -777. 


SYSTEM MACRO : WRITE LUN , MODE , BUFF [ , EV] 

Variables: LUN = Logical Unit Number (decimal) 

MODE = I/O Data Mode (0=IOPS BINARY, 1=IMAGE 

BINARY, 2=I0PS ASCII, and 3=IMAGE ASCII) 
BUFF = Starting Address of user's buffer 
SIZE = Maximum number of words to transfer (octal) 
EV = Event Variable Address 
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FORTRAN CALL: No subroutine is necessary to implement this Direc- 
tive. The standard WRITE statement as described in 
the PDF- 15 FORTRAN IV Manual is used. 

Example: DIMENSION TXTBF(256) 

WRITECe, 10)TXTBF 
10 FORMAT(256M) 

write out "WARNING, XFC OSCILLATING AT" followed by a 
frequency on LUN 3. 

WRITE(3, 10)IFQ 

10 FORMAT(28H WARNING, XFC OSCILLATING AT, 16//) 


DSKAL 


DSKAL generates a form of the QUEUE I/O Directive to reserve a disk 
storage area of a specified size. If the space is available, the 
starting address, physical disk number, and actual amount of space 
allocated^ (in increments of 128 decimal words) is returned to a 
Control Table which is contained within the issuing Task or in a 
COMMON Block. The actual allocation does not occur instantaneously; 
hence, one must test the Event Variable to determine completion. 
Event Variables returned are: +1, -15, -lj?4, and -777. 


SYSTEM MACRO : DSKAL_CTB [ , EV] 

Variables: CTB = Address of a Control Table of the 

following format: 

Word 1: Desired amount of disk 

storage which is replaced 
by the actual amount allocated 
if allocated. 

Word 2: Physical disk unit number 
(returned at completion of 
operation) . 

Word 3 : Absolute starting address of 
the space allocated relative 
to the physical disk unit 
number (returned at completion 
of the operation) . 

EV = Event Variable address 
^ which may exceed the amount requested. 
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Example: Request 700 decimal words of disk storage. (Since 

allocation is given in increments of 128 decimal words, 
the actual allocation will be 768 decimal words.) 

LAC (1274) /SETUP FIRST WD OF CONT TBL. 

DAC CTB+0 

DSKAL CTB,EV /REQUEST ALLOCATION OF 700 

WAITFOR EV /WORDS OF DISK STORAGE. 

FORTRAN CALL : CALL_DSKAL ( ICTB , NW [ , lEV] ) 

Variables: ICTB = Control Table (integer array). The Control 

Table is described below: 

Word 1: Actual amount of space al- 
located (returned at comple- 
tion of the operation) . 

Word 2 : Physical disk unit number 
(returned at completion of 
operation) . 

Word 3: Absolute starting address of 
the space allocated relative 
to the physical disk unit 
number (returned at completion 
of the operation) . 
lEV = Event Variable 

NW = Desired storage in words 

Example: Same as above except in FORTRAN. 

DIMENSION ICTB (3) 

CALL DSKAL (ICTB , 700 , IDKEV) 

CALL WAITER (IDKEV) 

Note: Space will not be allocated across disk unit 

bounds (i.e., from one unit to another). No 
more than 130,944 words may be allocated by a 
single DSKAL command. 


4.3.17 DSKDAL 


DSKDAL generates a form of the QUEUE I/O Directive to release a disk 
storage area, which had previously been allocated by DSKAL, from the 
Disk. Event Variables returned are: +1, “15, -104, and 
-777. 


SYSTEM MACRO: DSKDAL_CTB [ ,EV] 

Variables: CTB = Control Table Address. This address should 

be the same as that used by DSKAL which 
originally allocated the space. 

EV = Event Variable Address 
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Example: Request deallocation of the disk storage allocated 

in the previous section. There is no concern for 
when the disk space is actually freed. 

DSKDAL CTB 


FORTRAN CALL : CALL_DSKDAL ( ICTB f , lEV] ) 

Variables:- ICTB = Control Table (integer array) . This address 

should be the same as that used by DSKAL 
which originally allocated the space. 
lEV = Event Variable 

Example: Same as above except in FORTRAN 

DIMENSION ICTB(3) 

CALL DSKDALCICTB, lEV) 


4.3.18 DSKPUT 

DSKPUT generates a form of the QUEUE I/O Directive to output data onto 
the disk from a specified area in core. This Directive is used when 
total freedom in data structuring and random access capabilities are 
desired. Event Variables returned are: +1 and -N, where N is the 
contents of the disk status register if a disk error occurs. 


SYSTEM MACRO: DSKPUT__CTB [ , EV] 

Variables: CTB = Address of a Control Table of the 

following format: 

Word 1: Disk unit number 
Word 2: Starting address on disk 
Word 3: Starting address in core 
Word 4: Length of transfer in words 
EV = Event Variable address 
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FORTRAN CALL: 


CALL DSKPUT(ICTA,IOA,NW, ARRAY [ ,IEV] ) 


Variables ; 


ICTA = Device Control Table (integer array) . 

This array must be the same as that used 
to allocate the space onto which the data 
is being written since this uses infor- 
mation in the Control Table obtained via 
DSKAL 

lOA = Disk offset address. The relative position 
(in words) within an array at which the 
transfer to the disk is to begin. 

NW = Number of words (decimal) to transfer. 

ARRAY = The name of the array containing the data 
to be transferred, 
lEV = Event Variable 


Example: Allocate 1280 decimal words of disk storage and write 
out 256 words on the disk from BUF . Writing on disk 
is to begin 128 words beyond the starting address of 
the beginning of the disk storage area. 


DIMENSION ICTA(3),BUFC256) 

CALL DSKALCICTA, 1280, IDKEV) 

CALL WAITFRCIDKEV) 

CALL DSKPUTCICTA, 12 8 , 2 56, BUF , I DKEV) 


i|.3.19 DSKGET 

DSKGET generates a form of the QUEUE I/O Directive to read data from 
the disk into a specified area in core. This Directive is used where 
total freedom in data structuring and random access capabilities are 
desired. Event Variables returned are: +1 and -N, where N is the 
contents of the disk status register if a disk error occurs. 


SYSTEM MACRO: 

DSKGET 

_CTB [,EV] 



Variables : 

CTB 

= Address of 

a Control Table of 

the 



following 

format : 




Word 1 

; Disk unit number 




Word 2 

: Starting address 

on disk 



Word 3 

: Starting address 

in core 



Word 4 

: length of transfer in words 


EV 

= Event Variable address 
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FORTRAN CALL: 

CALL_ 

_DSKGET( ICTA, IOA,NW, ARRAY [,IEV] ) 

Variables : 

ICTA 


Device Control Table (integer array) . 

Array must be the same as that used to 
allocate the space from which the data 
is being read since this uses information 
in the Control Table obtained via DSKAL. 


lOA 


Disk offset address. The relative position 
(in words) within an array at which the 
transfer from the disk is to begin. 


NW 


Number of words (decimal) to transfer. 


ARRAY = 

The name of the array where data is to be 
transferred. 


lEV 

= 

Event Variable 


Example: Allocate 512 decimal words of disk storage and later 
read in the last 256 decimal words into BUF. 


DIMENSION ICTA(3),BUFC256) 
CALL DSKAL ( I CTA, 5 1 2 , I EV) 
CALL WAITFR(IEV) 


CALL DSKGET(ICTA,256,256,BUF, lEV) 


Example: This final FORTRAN example allocates 1024 words of disk 

storage, writes 256 words from four different arrays, later reads 
the last array of 256 words, and then deallocates the disk space 
and EXITS. 


COMMON BUF2(128) ,ICTA{3) ,BUF1(128) ,BUF3(128) ,BUF4(128) 

C 

C — ““ ALLOCATE 1024 WORDS OF DISK STORAGE 
C 

CALL DSKAL (ICTA, 1024 , lEV) 

CALL WAITER (lEV) 

C 

C INSURE ALLOCATION WAS MADE 

C 

IF (lEV .GT. 0) GO TO 20 
C 

C STORAGE NOT ALLOCATED, TYPE MESSAGE & EXIT 

C 

WRITE (3,10) 

10 FORMAT (20H ALLOCATION NOT MADE) 

CALL EXIT 
C 

C ALLOCATION MADE, WRITE OUT ARRAYS 

C 

20 CALL DSKPUT (ICTA , 0 , 256 , BUFl , lEV) 

CALL DSKCK (lEV) 

CALL DSKPUT ( ICTA, 256 , 256 ,BUF2 , lEV) 

CALL DSKCK (lEV) 

CALL DSKPUT ( ICTA, 512 , 512 ,BUF3 , lEV) 

CALL DSKCK (lEV) 
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READ IN LAST ARRAY FROM DISK 

CALL DSKGET (ICTA, 768, 256 ,BUF4, lEV) 
CALL DSKCK (lEV) 


RELEASE DISK SPACE & EXIT 

CALL DSKDAL (ICTA) 

STOP 

END 


SUBROUTINE DSKCK (lEV) 
CALL WAITER (lEV) 

IF CIEV .LT. 0 ) GO TO 10 

RETURN 

WRITE ( 3 , 20 ) 

FORMAT (IIH DISK ERROR) 
CALL EXIT 



4.3.20 ATTACH 


ATTACH generates a form of the QUEUE I/O Directive which requests the 
exclusive use of an I/O device. Once the Directive is accepted, no 
other Task may use the device regardless of priority. All requests 
by other Tasks, however, will be queued and processed whenever the 
device becomes free (DETACHED). The REASSIGN MCR Function, however, 
overrides the ATTACH. Event Variables returned are: +1, -6, -24, 
-IJZfl, - 102 , - 103 , and -777. 


SYSTEM MACRO: 

ATTACH_LUN[,EVl 

Variables : 

LUN = Logical Unit Number (decimal) 

EV = Event Variable Address 

Example: Attach device assigned to LUN 32. 

ATTACH 32,ATEV 

FORTRAN CALL: 

CALL_ATTACH (LUN [ , lEV] ) 

Variables : 

LUN = Logical Unit Number 

lEV = Event Variable 

Example : Same 

as above except in FORTRAN. 


CALL ATTACH(32, lEV) 


4.3.21 DETACH 

DETACH generates a form of the QUEUE I/O Directive which releases a 
device from the exclusive use of the issuing Task. Previous 
requests which were queued by the I/O Handler Task while ATTACHed will 
now be processed. The Task issuing the DETACH Directive must be the 
Task which ATTACHed the device. Event Variables returned are: +1, 

-6, -1^1, - 102 , - 103 , and -777. 

SYSTEM MACRO: DETACH_LUN [ ,EV] 

Variables: LUN = Logical Unit Number (decimal) 

EV = Event Variable Address 
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Example: Detach device assigned to LUN 23. 

DETACH 23,DTEV 

FORTRAN CALL : CALL_DETACH (LUN [ , lEV] ) 

Variables : LUN = Logical Unit Number 

lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL DETACHC23, lEV) 

4.3.22 SEEK (OPEN FILE FOR INPUT) 

SEEK generates a form of the QUEUE I/O Directive which requests the 
I/O Handler Task assigned to the indicated Logical Unit Number to 
search the device's file directory for a specified file name. This 
Directive is used to initiate file-oriented transfers using the READ 
Directive. Once the SEEK has been accepted by the I/O device, it 
effectively attaches the LUN to the issuing Task. Event Variables 
returned are: +1, -6, -Ij?, -12, -13, -101, -102, -103, and -777. 


SYSTEM MACRO: SEEK_LUN ,FLNAM,EXT [ ,EV] 

Variables: LUN = Logical Unit Number 

FLNAIi = File name (1-6 characters) 

EXT = File name extension (1-3 characters) 
EV = Event Variable Address 

Example: Search the directory of the file-oriented device 

associated with LUN 6 for a file named DATA SRC. 

SEEK 6, DATA, SRC, EV 

FORTRAN CALL : CALL_SEEK (LUN , nHFLNAM , nHEXT [ , lEV] ) 

Variables : LUN = Logical Unit Number 

n = Niimber of characters in file name or 

extension. 

FLNAM = File Name (1-5 characters) 

EXT = File Name Extension (1-3 characters) 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL SEEK(6,4HDATA,3HSRC, lEV) 

C WAIT FOR SEEK TO COMPLETE 

CALL WAITFR(IEV) 
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4.3.23 ENTER (OPEN FILE FOR OUTPUT) 


ENTER generates a form of the QUEUE I/O Directive which requests the 
I/O Handler Task assigned to the indicated Logical Unit Number to 
search the device's file directory for a free Directory Entry Block 
in which to place the file ncime specified. This Directive is issued 
prior to issuing a WRITE Directive to a file-oriented device. The 
actual recording of the file name does not occur until the CLOSE. 
Once the ENTER has been accepted by the I/O device, it effectively 
attaches the LUN to the issuing Task. Event Variables returned are; 
+1, -6, -lj2f, -12, -14, -15, -lj2fl, - 102 , - 103 ,. and -777. 

SYSTEM MACRO; ENTER_LUN,FLNAM,EXT[ ,EV] 

Variables: LUN = Logical Unit Number (decimal) 

FLNAM = File Ncime (1-6 characters) 

EXT = File Name Extension (1-3 characters) 

EV = Event Variable Address 

Example: Enter into the directory of the file-oriented device 
associated with LUN 6 the file name DATA SRC. 

ENTER 6, DATA, SRC, EV 

FORTRAN CALL: CALL_ENTER (LUN,nHFLNAM,nHEXT [ , lEV] ) 

Variables ; LUN = Logical Unit Number 

n = Number of characters in file name or 

extension. 

FLNAM = File Name (1-5 characters) 

EXT = File Name Extension (1-3 characters) 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL ENTER(6,4HDATA,3HSRC, lEV) 


^.3.2^ DELETE 

DELETE generates a form of the QUEUE I/O Directive which requests the 
I/O Handler Task assigned to the indicated Logical Unit Number to re- 
move the indicated file name from the device's file directory. Event 
Variables returned are: +1, -6, - 10 , -12, - 101 , - 102 , - 103 , and -777. 
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SYSTEM MACRO: DELETE_LUN,FLNAM,EXT L ,EV] 

Variables: LUN = Logical Unit Number (decimal) 

FLNAM = File Name (1-6 characters) 

EXT = File Name Extension (1-3 characters) 

EV = Event Variable Address 

Example: Delete the file DATA SRC from the directory of the file- 
oriented device associated with LUN 6 , 

DELETE 6, DATA, SRC, EV 

FORTRAN CALL : CALL_DELETE (LUN , nHFLNAM , nHEXT [ , lEV] ) 

Variables : LUN = Logical Unit Number 

n = Number of characters in file name or 

extension. 

FLNAM = File Name (1-5 characters) 

EXT File Name Extension (1-3 characters) 

lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL DELETEC6,4HDATA, 3HSRC, lEV) 


i|.3.25 CLOSE 


CLOSE generates a form of the QUEUE I/O Directive which instructs the 
appropriate I/O Handler Task that the issuing Task has completed an 
I/O operation to the named file which resides on the device. Once a 
CLOSE is issued, subsequent transfers to or from the CLOSEd file are 
not possible until an appropriate SEEK or ENTER is again issued. Event 
Variables returned are: +1, -6, -11, -12, -15, -101, -102, -103, 
and -777. 

SYSTEM MACRO: CLOSE_LUN , FLNAM, EXT [ ,EV] 

Variables: LUN = Logical Unit Number (decimal) 

FLNAM = File Name (1-6 characters) 

EXT = File Name Extension (1-3 characters) 

EV = Event Variable Address 

Example: Close the file DATA SRC on the file-oriented device 
associated with LUN 6 . 

CLOSE 6, DATA, SRC, EV 

FORTRAN CALL : CALL CLOSE (LUN , nHFLNAM , nHEXT [ , lEV] ) 
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Variables: 


LUN = Logical Unit Number 

n = Number of characters in file name or 

extension. 

FLNAM = File Name (1-5 characters) 

EXT = File Name Extension (1-3 characters) 

lEV = Event Variable 


Example: Same as above except in FORTRAN. 

CALL CLOSE(6,4HDATA,3HSRC, lEV) 


^.3.26 HANDLER INFORMATION 


This Directive provides rudimentary information about the physical 
device and the I/O handler associated with a particular Logical Unit 


Number (LUN) . Handler information is coded into a single word, which 


in 

the 

requestor ' s 

Event Variable as follows: 

Bit 

0 

UNUSED 

This bit is unused to allow a handler to 
return a value of -6 if this function was 
not implemented. 

Bit 

1 

INPUT 

Set to 1 if data can be input from the 
device to the computer. 

Bit 

2 

OUTPUT 

Set to 1 if data can be output from the 
computer to the device. 

Bit 

3 

FILE-ORIENTED Set to 1 if the I/O handler treats 


the device as being "file-oriented". 
A deviee is "file-oriented" if SEEK and 
ENTER are required prior to READ and 
WRITE, respectively. "File-oriented" 
implies, but does not guarantee, the 
existence of a file directory or that the 
device is bulk or mass storage. 

Bits 4 UNIT Unit number, 

thru 
11 


Bits 12 
thru 

17 


DEVICE CODE These six bits allow up to 63 decimal 
devices (zero is not a legal device 
code) . The codes listed below are fixed 
for standard DEC devices. Users should 
assign codes to their own devices starting 
with 63 and working towards lower numbers. 


1 

TT — The 
and 

TTY terminals (console, LT15, 
LT19) 

2 

DK — The 

RF15 fixed-head DECdisk 

3 

DP — The 

RP02 disk pack 

4 

DT — The 

TC02D DEC tape 

5 

MT — The 

TC59 MAGtape 
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6 PR — The PC15 Paper Tape Reader 

7 CD — The CRjZfSB Card Reader 

10 PP — The PCI 5 Paper Tape Punch 

11 LP — The LP15 Line Printer 

12 VP — The VP 15 Storage Scope 

13 VT — The VT15 Display 

SYSTEM MACRO: HINF_LUN,EV 

Variables: LUN = Logical Unit Number (decimal) 

EV = Event Variable Address 

FORTRAN CALL: CALL_HINF (LUN , lEV) 

Variables : LUN = Logical Unit Number 

lEV = Event Variable 

4.3.27 DISABLE 

This Directive causes the Executive to render the specified Task in- 
capable of responding to other Directives except ENABLE. The Task 
is not deleted from the system. If the Task is active, it will con- 
tinue to execute, however, schedule activations for that Task will 
be ignored when they come due. When the Task is subsequently ENABLEd, 
previously established rescheduling for the Task will continue in 
effect. Event Variables are: +1 and -201. 

SYSTEM MACRO: DISABLE_TSKNAM [ ,EV] 

Variables: TSKNAM = Name of Task (1-6 characters) 

EV = Event Variable Address 

Example: Disable Task named SCAN. 

DISABLE SCAN^EV 

FORTRAN CALL : CALL_DISABL (nHTSKNAM [ , lEV] ) 

Variables : n = Number of characters in Task Name 

TSKNAM = Name of Task (1-5 characters) 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL DISABL(4HSCAN, lEV) 
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i|.3.28 ENABLE 


This Directive causes the Executive to restore the specified Task to 
its normal state (i.e., as it was before DISABLE was issued). Event 
VarieUales returned are; +1 and -201. 

SYSTEM MACRO: ENABLE_TSKNAM [ , EV] 

Variables; TSKNAM = Name of Task (1-6 characters) 

EV = Event Variable Address 

Exeimple; Enable Task SCAN which is currently disabled. 

ENABLE SCAN^EV 

FORTRAN CALL : CALL_ENABLE (nHTSKNAM [ , lEV] ) 

Variables; n = Number of characters in Task Name 

TSKNAM = Name of Task (1-5 characters) 
lEV = Event Variable 

Example: Same as above except in FORTRAN. 

CALL ENABLEC4HSCAN, lEV) 

A. 3. 29 FIX 

This Directive instructs the system to load an inactive Task into an 
available partition. The Task is not executed, but is fixed-in-core 
and may therefore respond rapidly to a request for execution. FIX 
does not wait for a Task to be loaded before setting EV to +1. The 
Directive may not be issued to an active Task. Event Variables re- 
turned are: +1, -201, -202, -204, -207, and -210. 

SYSTEM MACRO; FIX__TSKNAM( ,EV] 

Variables; TSKNAM = Name of Task (1-6 characters) 

EV = Event Variable Address 

FORTRAN CALL; CALL FIX (nHTSKNAM [, lEV] ) 
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Variables: 


n = Number of characters in Task Name 

TSKNAM = Name of Task (1-5 characters) 
lEV = Event Variable 

4.3.30 UNFIX 

This Directive instructs the Executive to nullify a FIX Directive 
thereby freeing a partition for use by other Tasks. If UNFIX is issued 
to a Task which is currently running, the Task will be allowed to run 
to completion before the Directive becomes effective. Event Variables 
returned are: +1, - 201 , and - 201 . 

SYSTEM MACRO: UNFIX_TSKNAM [ ,EV] 

Variables: TSKNAM = Name of Task (1-6 characters) 

EV = Event Variable Address 

FORTRAN CALL : CALLJUNFIX (nHTSKNAM [ , lEV] ) 

Variables: n = Number of characters in Task Name 

TSKNAM = Name of Task (1-5 characters) 
lEV = Event Variable 

4.3.31 DECLARE A SIGNIFICANT EVENT 

The DECLAR Directive provides the means for declaring to the Executive 
that a Significant Event has occurred. The occurrence of a Significant 
Event signals the Executive to initiate a scan of the Active Task List 
with control passing to the Task having the highest priority. DECLAR 
is particularly useful for intertask signalling and synchronization. 

SYSTEM MACRO : DECLAR 
FORTRAN CALL : CALL_DECLAR 

4.3.32 TIME 

The TIME System Macro and FORTRAN subroutine obtain the time of day 
from the Executive ' s internal clock and deposit these values in three 
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locations specified by the issuing Task 


SYSTEM r4ACRO : 

TIME_ 

Hr , Min , Sec 



Variables: 

Hr 

= Hours 

(0 - 

23) 


Min 

= Minutes 

(0 - 

59) 


Sec 

= Seconds 

(0 - 

59) 


FORTRAN CALL: CALL TIME{ITIME) 


Variables: ITIME = Three word Integer array as follows: 

ITIMEd) = Hours (0 - 23) 
ITIME (2) = Minutes (0 - 59) 
ITIME (3) = Seconds (0 - 59) 


4.3.33 DATE 


The DATE System Macro and FORTRAN subroutine obtain the current time 
(hours, minutes, and seconds) and date (month, day, and year) from the 
Executive's internal clock and calendar. The values obtained are de- 
posited in six locations specified by the issuing Task. 


SYSTEM MACRO: DATE_Hr ,Min,Sec,Mon,Day,Yr 


Variables : 


Mon = Month (1 - 12) 

Day = Day (1 - 31) 

Yr = Year (0 - 99) 

Hr = Hours (0 - 23) 

Min = Minutes (0 - 59) 

Sec = Seconds (0 - 59) 

Note : The month and day reversed in European 
format. 


FORTRAN CALL: CALL DATE(IDATE) 


Variables : 


IDATE = Six word Integer array as follows: 

IDATE(l) = Month (1 - 12) 
IDATE (2) = Day (1 - 31) 
IDATE (3) = Year (0-99) 
IDATE (4) = Hours (0 - 23) 
IDATE (5) = Minutes (0 - 59) 
IDATE (6) = Secnnds (0 - 59) 


4.3.34 INTENTRY 

The INTENTRY System Macro results in an entry to the Executive's Register 
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Save Routine. The Save Routine obtains the current contents of all 
active system registers, including the AC, Index and Limit Registers, 
first four Autoincrement Registers, and deposits them in a save area 
created by the Macro Assembler during expansion of the System Macro. 
This Directive may only be issued from within an interrupt service 
routine and must be the first instruction of the interrupt routine. 

The saved registers are restored by execution of the INTEXIT Directive. 
Appendix E provides a listing of all registers which are saved. 

SYSTEM MACRO: INTENTRY_CL 

Variable: CL = Interrupt service routine entry address. 

(connect location) 

FORTRAN CALL: No subroutine is provided to implement this since 
FORTRAN is not an appropriate language for writing 
interrupt handling routines. 

Example: See example in next section (4.3.35) 

^.3.35 INTEXIT 

The INTEXIT System Macro results in an entry into the Executive's 
Register Restore Routine. This routine restores all active registers 
saved by the INTENTRY Directive , Debreaks , and returns to the inter- 
rupted Task. INTEXIT may only be issued from within an interrupt 
service routine. 

SYSTEM MACRO : INTEXIT_CL 

Variable: CL = Interrupt service routine entry address 

(connect location) 

FORTRAN CALL: No subroutine is provided to implement this since 
FOR.TRAN is not an appropriate language for writing 
interrupt handling routines. 

Example: An interrupt service routine named ADINT for an A/D 
Converter is to use the INTENTRY and INTEXIT System 
Macros. 
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INTENTRY ADINT 


INTEXIT ADINT 


/MUST BE PLACED AT THE ENTRANCE 
/ TO THE INTERRUPT ROUTINE. 

/SECTION TO SERVICE INTERRUPT. 

/RESTORE REGISTERS, DEBREAK, 

/ AND RETURN TO INTERRUPTED 
/ TASK. 
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CHAPTER FIVE 
TASK BUILDER 


5.1 INTRODUCTION 

The TASK BUILDER program, TKB, is an ADVANCED Software System's pro- 
gram used to build user's Tasks from relocatable binary files. TKB 
is quite similar to the CHAIN program allowing very elaborate overlay 
structures to be built. 

The process of Task building is one where relocatable binary files are 
linked together along with library functions to constitute an executable 
Task that runs under the control of the Real-Time Monitor (RSX-15) . A 
resultant Task is defined by its naune (Task name), default run priority, 
core partition and common block requirements, and resident code. Once 
a Task has been built it may be incorporated into the real-time operat- 
ing system under control of the Real-Time Monitor from DECtape or 
paper tape. 


5.2 TASK BUILDER DESCRIPTION 


The following description of TKB assumes the reader has a thorough 
understanding of the ADVANCED Software System CHAIN* program since only 


*TKB and CHAIN have identical Input/Output Device Assignments and load- 
ing procedures. (See CHAIN & EXECUTE Manual DEC-15- YWZA-DN2) 
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minor differences exist between the two. Only areas which are not part 
of the CHAIN program will be amplified in this section. Answers to all 
questions, as for the CHAIN program, must end with an ALT MODE. 

LIST OPTIONS 

SZ to output size in load maps, GM to output Global Symbol & 
File names instead of program names in load maps, NM for no 
load map, and PAR & PAL for pause after outputting resident 
code and pause after outputting each Link. 

NAME TASK 

Identical to NAME XCT FILE in CHAIN. 

SPECIFY DEFAULT PRIORITY 

This is the default priority of the Task which will be assumed 
at INSTALL time. Default priority is optional and can be any 
number from 1 (highest priority) to 512 (lowest priority) . 

DESCRIBE PARTITION 

This is the name of the core partition in which the Task is 
to be executed. The form of the partition description is: 

NAME (BASE ADDRESS , SIZE) . The NAME is the name of a Partition 
defined in the RSX System, BASE is the octal start address of 
the partition, and SIZE is the size of the partition which 
the Task is to occupy. 

DESCRIBE SYSTEM COMMON BLOCKS 

These are the names of the Common Blocks which are referenced 
by the Task but are common to all Tasks in the RSX System. 

The form of the Common Blocks is: NAME (BASE ADDRESS, SIZE) . 

NAME is the name of the Common Block defined in the RSX System, 
BASE is the octal start address of the Common Block, and SIZE 
is the maximum size of the Common Block in which data is to 
be placed. Additional Common Block descriptions (maximum of 
four) may be specified by separating the descriptions with 
commas. Blank and Named Common declared in FORTRAN programs 
will be included in the Task's partition block if not speci- 
fied in a DESCRIBE SYSTEM COMMON BLOCKS description. Blank 
Common assumes the default name of .XX. 

DEFINE RESIDENT CODE 

Identical to CHAIN program. 

DESCRIBE LINKS & STRUCTURE 

Identical to CHAIN program. 
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5.3 EXAMPLE USING THE TASK BUILDER 


tc 

KM9-15 V5A 
$A DKl -4/DTl -6 


$TK3 


TASK BUILDER VIA 


LIST OPTIONS 
>SZ 

name task 

>su?^ 

SPECIFY DEFAULT PRIORITY 
> 40 

DESCRIBE PARTITION 
>P40. 0(40000,15000) 

DESCRIBE SYSTEM COMMON BLOCKS 
>FLA 0(36200,600) 

DEFINE RESIDENT CODE 
>MAIN,F1 ,F2,MAC 
DESCRIBE LINKS & STRUCTURE 


MAIN 

40020-40047 

00030 

FI 

40050-401 17 

00050 

F2 

40120-40255 

00136 

MAC 

40256-40303 

00026 

WAFF. 1 

40304-40316 

00013 

DS GF . 2 

40317-40360 

00042 

EXIF.I 

40361-40363 

00003 

.DA 

40364-40432 

00047 

.DAA 

40433-40501 

00047 

BCDIO 

40502-43537 

03036 

.SS 

43540-43617 

00060 

ST0.3 

43620-43631 

00012 

FI 0.3 

43632-44311 

00460 

0TS.5 

44312-44440 

00127 

.SP.3 

44441-44560 

00120 

IMTEAE 

44561-44674 

00114 

RE LEAF 

44675-45736 

01042 

.C3 

45737-45756 

000 20 

BLANK 

COMMON 


.XX 

45757-46266 

00310 

CORE R 

SQ‘D 



40000-46266 

06267 

KMp- 15 

V5A 
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tc 

KM9-15 V5A 

$A DKI ”4/0X1 ”6 

$TKB 


TASK BUILDER VIA 
LIST OPTIONS 

>sz 

NAME TASK 
>STORE 

SPECIFY DEFAULT PRIORITY 
>35 

DESCRIBE PARTITION 
>P40. 0(40000, 15000) 

DESCRIBE SYSTEM COMMON BLOCKS 
>FLAG( 36200, 600) 

DEFINE RESIDENT CODE 
>STORE 

DESCRIBE LINKS & STRUCTURE 


STORE 

40020-40317 

00300 

WAFF, 1 

40320-40332 

00013 

RUNF. 2 

40333-43404 

30052 

EXIF. 1 

40405-40407 

00003 

DSAF.2 

40410-40433 

00024 

DSPF.2 

43434-40475 

00042 

FTS.2 

40476-40543 

00046 

. SC 

40544-40617 

00054 

. EE 

40620-43710 

00071 

.EF 

4071 1-41026 

00116 

.EC 

41027-41072 

00044 

.DA 

41073-41 141 

00047 

. DAA 

41142-41210 

00047 

3CDI0 

4121 1-44246 

03036 

.SS 

44247-44326 

00060 

ST0.3 

44327-44340 

00012 

FI0.3 

44341-45020 

00460 

0TS.5 

45021-45147 

00127 

.SP.3 

45150-45267 

00120 

INTEAE 

45273-45403 

00114 

RELEAE 

45434-46445 

01042 

.03 

46446-46465 

00020 

BLANK 1 

COMMON 


.XX 

46466-47000 

30313 

CORE REQ’D 



40000-47003 

07001 

KM9“ I 5 

V5 A 



S 
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6.1 INTRODUCTION 


CHAPTER SIX 

SYSTEM CONFIGURATOR 


The RSX-15 System is supplied on DECtape (RSX COLD START MASTER TAPE) 
with each PDP-15/35 computer as a very generalized software package. 
The Master Tape of the system consists of the RSX Executive, Multi- 
Teletype Handler, Disk Handler, Monitor Console Routine (MCR) Func- 
tion Tasks, and one running Task called the SYSTEM CONFIGURATOR. The 
SYSTEM CONFIGURATOR enables the user to tailor his software to fit his 
requirements . 

The SYSTEM CONFIGURATOR allows the user to specify core size, disk 
size, number of Teletypes, clock frequency. Partition descriptions, 
system COMMON Block descriptions, and a description of peripheral I/O 
units. Partitions and COMMON Blocks may be defined anywhere between 
the top of the Executive (over the SYSTEM CONFIGURATOR) thru the top 
of core (as long as they do not overlap each other) . Partition Blocks 
and the "Pool of Empty Nodes" are constructed in core above the 8K 
that has not been defined as a part of a Partition or COMMON Block. 
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After the Pool and Partition Blocks have been constructed, all Tasks 
recorded on DT-0 that can be installed in the newly configured system, 
are installed. After installation from DT-0, the number of empty 
nodes in the Pool is typed out, and the system is left running. 


6.2 INSTALLING THE RSX SYSTEM 


When the user receives the RSX COLD START MASTER TAPE he should per- 
form the following steps to configure the RSX Software to best fit his 
needs and requirements ; 

1) Mount the RSX COLD START MASTER TAPE onto DECtape unit zero 
(WRITE LOCK) . 

2) Read into location 00000 the RSX DECTAPE BOOTSTRAP from the 
High Speed Paper Tape Reader. This will cause the Cold Start 
image to be read in from the Master Tape and the SYSTEM 
CONFIGURATOR Started. 

3) Answer all questions asked by the SYSTEM CONFIGURATOR (See 
section 6.3). 

4) When the system configuration has completed* and the message 
"MCR>" is printed on the console Teletype, the user should 
install his own Tasks into the system and issue the "SAVE“ 

MCR Function command to save an image of the new system on 
the disk. 

5) To make a backup copy of the system, mount scratch tapes on 
DECtape units one and two (one at a time if only a limited 
number of DECtapes are available) and read into location 00000 
the "DISK TO DECTAPE" from the High Speed Paper Tape Reader to 
copy an image of the disk(s) onto the DECtapes. This backup 
system can be restored by reading in "DECTAPE TO DISK" from 
the High Speed Paper Tape Reader. NOTE: Two DECtapes are 
required for each disk unit saved. Writing begins on DECtape 
unit one for the first half of the first disk and automatical- 
ly transfers to DECtape unit two when unit one is filled. 

This process is automatically repeated (from DECtape one to 
two) until all disks have been saved. (Rewinding and unload- 
ing DECtapes between save/restore operations is performed by 
the save and restore programs.) A similar procedure is used 
to restore the system from DECtape to disk. The tapes may be 
restored in any order with transfer beginning from DECtape 
unit one and continuing with DECtape unit two. Each DECtape 
will contain 131,jaf72ig. disk words followed by a descriptor 
block. ^ 


* The SYSTEM CONFIGURATOR is a one-time Task that automatically removes 
itself once the system has been configured. 
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6 ) 


Read into location 00000 the RSX DISK (WARM START) BOOTSTRAP 
from the High Speed Paper Tape Reader. This will cause the 
restored RSX System to be brought in from the disk and the 
message ‘'MCR>" to be printed on the console Teletype. The 
System is now ready to accept commands from the user. 


6.3 STEP BY STEP SYSTEM CONFIGURATION PROCEDURE 


QUESTION ANSWER 
SPECIFY CORE SIZE> 

16K, 20K, 24K, 28K, or 32K (Size of user's core memory) 

SPECIFY NUMBER OF DISK UNITS> 

1 to 8 (Number of physical disk units ) 

SPECIFY NUMBER OF TTY'S> 

1 to 17 (Number of Teletypes connected to the system. ) 

SPECIFY NUMBER OF CLOCK TICKS PER SECOND> 

1 - 1000 (This is the line frequency used to set the Real-Time 
Clock frequency in the RSX Executive, and will normally be 50 
or 60 .) 

DEFINE PARTITIONS "NAME (BASE, SIZE) ” 

These are the names (NAME) of all partitions in the System along 
with their base addresses (BASE) and sizes (SIZE) . A line with 
only a terminator (carriage return or ALTMODE) will terminate the 
response. 

DEFINE SYSTEM COMMON BLOCKS "NAME (BASE , SIZE) " 

These are the names of COMMONS to be used for inter-task coiranunica- 
tion or extra-task data storage. Core is permanently allocated and 
these COMMONS are always available. The Names, Base Addresses, and 
Sizes are specified. A line with only a terminator (carriage re- 
turn or ALTMODE) terminates the response. 

SPECIFY DEVICE NAMES AND UNIT NUMBERS (ONE PER LINE) 

List only devices which will be used by the user. Device names 
are two characters in length followed by a unit number. (The Tele- 
types and Disk are specified in the system.) The following are 
ncimes of devices for which I/O Handler Tasks are supplied with the 
system: 

LP = Line Printer 
DTn = DEC tape (n=j? to 7) 

PR = High Speed Paper Tape Reader 
PP = High Speed Paper Tape Punch 
A line with only a terminator (carriage return or ALTMODE) termi- 
nates the response. 
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INSTALLATION OF TASKS FROM DT0 

This process requires no response from the user. All Tasks on DT0 
that can be installed, are installed in the System at the default 
priority defined at Task Building time. When all Tasks have been 
installed, the CONFIGURATOR continues with: 

nnnnn NODES IN POOL 

This is the number (nnnnn) of empty nodes (in decimal) in the POOL 
available for queueing and scheduling. The CONFIGURATOR continues 
with : 

SYSTEM IS RUNNING 

This indicates to the user that the system is running and the 
Resident MCR responds by typing "MCR>". The System is now ready 
to accept user's commands from the console Teletype. 
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5.ii EXAMPLE OF A SYSTEM CONFIGURATION PROCEDURE 


J?SX SYSTEM CONFIGURATION 
SPECIFY CORE SIZE >24K 

SPECIFY NUMBER OF DISK UNITS >1 

SPECIFY NUMBER OF TTY’S >4 

specify number OF CLOCK TICKS PER SECOND >C0 

DEFINE PARTITIONS "NAMECBASE,SIZE) " 

>MCRC 10000, 1603) 

>10.1 Cl 1630,3000) 

>10.2(35200,1000) 

>P14. 6(14600, 3200) 

>P21. 0(21000, 5500) 

>P26. 5(26503, 6500) 

>P40. 0(40000, 15000) 


DEFINE SYSTEM COMMON BLOCKS "NAME(BASE,S IZE) ” 

>. XX(20000,700) 

> FLA 0(36 203,603) 

> 

SPECIFY DEVICE NAMES & UNIT NUMBERS (ONE PER LINE) 
>DT0 
>DT1 
>DT2 
>DT3 
>PR 
>PP 


INSTALLATION OF TASKS FROM DT-0 
00171 NODES IN POOL 
SYSTEM IS PUNNING 


MCR>SAVE 
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6.5 DESCRIPTION OF SYSTEM CONFIGURATOR ERROR MESSAGES 


+++ WOULD OVERFLOW ADJACENT AREAS — RETYPE 

A Partition and/or COMMON Block has overflowed in an adjacent 
area. The user must redefine the COMMON or Partition. 

+++ SYNTAX ERR AT "X" — RETYPE 

The illegal character "X" was found in the command string, retype 
the line, 

INVALID SIZE — RETYPE 

Illegal core size. Must be either 16K, 20K, 24K, 28K, or 32K, 
INVALID NUMBER — RETYPE 

Illegal number of disk units. Teletype units, or clock frequency 
setting. 

tf+ NAME ALREADY USED — RETYPE 

The name of the Partition or COMMON Block is already defined in 
the system. Partitions and COMMON Blocks may not have the same 
name. 

DEVICE NAME/UNIT ERR — RETYPE 
Device name and unit already defined. 

*** DISK READ ERR 

A disk read error has occurred. The system will halt and wait 
for the user to manually depress the continue switch to retry the 
disk read. 

*** DISK WRITE ERR 

A disk write error has occurred. The system will halt and wait 
for the user to manually depress the continue switch to retry the 
disk write. 

*** RE-ENTRANT ECO PACKAGE NEEDED 

The user's machine does not have the RE-ENTRANT ECO PACKAGE 
required to run RSX. Contact your local field service office. 

*** INSUFFICIENT FREE CORE — RE-STRUCTURE 

Insufficient free core for storage of all Partition Blocks or out 
of nodes in the Pool, 

TASK "XXXXXX" NOT INSTALLED, TASK ALREADY IN SYSTEM 

The Task XXXXXX is already installed in the system. 

TASK "XXXXXX" NOT INSTALLED, PARTITION NOT IN SYSTEM 

The Task XXXXXX was built for a partition which is not defined in 
the system. 
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TASK "XXXXXX“ NOT INSTALLED, TASK WOULD OVERFLOW PARTITION 

The Task XXXXXX is larger than the partition defined for it in the 
system. 

TASK "XXXXXX" NOT INSTALLED, OUT OF DISK STORAGE 

The Task XXXXXX is larger than the amount of available Disk stor- 
age required to install the Task. 

TASK "XXXXXX" NOT INSTALLED, INPUT CHECKSUM ERR 

An input checksum error occurred while installing Task XXXXXX 
from DEC tape. 

TASK "XXXXXX" NOT INSTALLED, INPUT PARITY ERROR 

An input parity error occurred while installing Task XXXXXX from 
DEC tape . 

TASK "XXXXXX" NOT INSTALLED, SYSTEM COMMON BLOCK ERR 

COMMON Block not defined in system or COMMON Block BASE and/or 
SIZE specified incorrectly (to the Task Builder) . 

TASK "XXXXXX" NOT INSTALLED, READ ERROR 

An illegal DECtape block number was found or a DECtape 
error exists. 

TASK "XXXXXX" NOT INSTALLED, NO DEFAULT PRIORITY 

The Task XXXXXX was not given a default priority at Task Building 
time. The INSTALL MCR Function can be used to install the Task 
once System Configuration has completed. 
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CHAPTER SEVEN 
SYSTEM ORGANIZATION 


7.1 INTRODUCTION 

The RSX System is organized into several units consisting of: The 
Executive, Partitions, Partition Blocks, System COMMON Blocks, several 
linked lists, and a pool of empty list nodes. The Executive, or heart 
of the system, lies entirely in the lower 4K memory bank and consists 
of the Resident MCR Task, Teletype and Disk I/O Handler Tasks, and 
assorted routines to properly carry out the functions of a real-time 
operating system. The remaining area of core memory is available for 
Partitions, Partition Blocks, System COMMON Blocks, and the Pool of 
Empty Nodes. The following sections describe the system in more detail. 

7.2 RSX BOOTSTRAPS 

The RSX DECTAPE BOOTSTRAP is read in at location 00000 and starts a 
DECtape to core transfer from tdpe block zero into core location 30 , 

The size of the image loaded is the same as the image that was recorded 
and is determined by the word count and current address registers 30 & 
31. This bootstrap is normally used to initiate a COLD START, but can 
also be used to initiate a WARM START of a system that does not use the 
disk, i.e., to load an image of a system where all Tasks have been 
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fixed- in-core, viz., an emergency system in case of disk failure. 

The RSX DISK (WARM START) BOOTSTRAP is a program used to restore a 

core image of the system (recorded by a SAVE MCR Function), from 
disk unit zero into core memory. 

The DISK bootstrap is read into location 00000 , clears the disk con- 
troller, and begins transfer starting from the beginning of disk zero 
and core location 00030 , Transfer continues until the entire core 
memory has been restored. When the system has been successfully re- 
stored, control is transferred to the address specified by R1 (abso- 
lute location 101 in the System Communications table) causing the 

O 

system to be started. 


7,3 RSX MEMORY MAP USAGE 


rh 16K-*'32K 


Partitions, 

> Partition 

Blocks, COMMON 
Blocks , and the 
Pool of Empty 
! Nodes , 



Partitions required 
to install the 
pre-built MCR & 

I/O Handler Task 
supplied on the 
Cold Start Image 
Tape. Normally, 
the I/O Handler 
Tasks are rebuilt 
to run in parti- 
tions that satisfy 
requirements of 
particular 
applications . 


_ip,_A I 16 ^ 0 _ul!i 00 ± . 
IQ.J. L1.5l0.0^0Ji) — 
ig. 2 . a4400L50^) _ 
ig.l_ (11610 t26JSf}_ 
MCR (icrcfcfg.iegflfv 


RSX EXECUTIVE 


8K 

V Partitions and 
COMMON Blocks*^ 



Figure 7.1 


* Unspecified core space between Common Blocks and Partitions which 
exist between the RSX Executive and the 8K memory boundary is not used 
by the system. 
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7.4 SYSTEM DEQUES 


The RSX System uses linked lists, rather than tables, to maintain 
system information. These lists are linked together as Double Ended 
Queues called deques. Each deque consists of a listhead and list 
elements, or nodes, circularly linked by both forward and backward 
pointers. The first word of a node or listhead is a forward pointer 
containing the address of the next node (or the listhead) looking 
forward. The second word of a node or listhead is a backward pointer 
containing an address of the previous node (or the listhead) looking 
backward. The listhead consists of only the two pointers. All nodes 
in a deque consist of the two pointers followed by eight words of data. 
Some of the major deques used in the RSX System are the Active Task 
List (ATL) , the System Task List (STL), the Clock Queue, and the 
Physical Device List (PDVL) . 



Figure 7.2 A three node deque 



Figure 7.3 An empty deque 
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7.^.1 POOL 


During System Configuration, core which has not been specified by the 
user for other purposes (viz.. Partitions and COMMON Blocks), is 
divided into ten-word blocks (empty ten-word nodes) and linked to- 
gether forming a deque called "The Pool of Empty Nodes" or "Pool". 
When a node is needed to expand a list, it is taken ("Taken" implies 
changing the node pointers, not moving ten words of data) from the 
Pool. When a node is no longer needed, it is returned to the Pool. 


7.^.2 THE SYSTEM TASK LIST (STL) 


The System Task List (STL) is a directory of Tasks in the system. 

The STL is a deque consisting of one node for each Task currently in 


the system. An STL node has the following format: 


Word 0 
Word 1 
Word 2 
Word 3 
Word 4 
Word 5 
Word 6 
Word 7 
Word 10 
Word 11 


— Forward pointer 
— ■ Backward pointer 

— Task name (first half in .SIXBT) 

— Task name (second half in .SIXBT) 

— Flags and Default priority 

— Partition Block Address 

— Disk address of Task image 

— Size of resident image 

— Disk storage allocated 
-- Task entry point 


Word 4, the Flags and Default priority, has the following bit designa- 
tions : 


Bit 0 — set when the 
Bit 1 — Unused 
Bit 2 — set when the 
Bit 3 — set when the 
Bit 4 — Unused 
Bit 5 — Unused 
Bits 6 - 17 -- Task's 


Task is active 

Task is disabled 
Task is "Fixed in Core" 

default priority 


Word 6, the Disk address, contains the disk unit number in bits 15-17. 


Nodes are added to the STL whenever a Task is INSTALLed into the system, 
and deleted from the STL when a Task is REMOVEd from the system. 
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1A3 THE ACTIVE TASK LIST (ATL) 


The Active Task List (ATL) is a priority ordered list of Active Tasks. 


The ATL is a deque consisting of one node for each Active Task in the 


system. An ATL node has the following format: 


Word 0 
Word 1 
Word 2 
Word 3 
Word 4 
Word 5 
Word 6 
Word 7 
Word 10 
Word 11 


— Forward pointer 

— Backward pointer 

— Task neune (first half .SIXBT) 

— Task neune (second half .SIXBT) 

— Task run priority 

— Partition block address 

— STL node address 

— Task status indicator 

— Start or resumption address 

— Event variable address 


The ATL is ordered by the priority of the Active Tasks and is used to 
drive the system. The order in which Tasks are considered is determined 
by scanning the list, and the action to be taken is determined by 
examining the Task status word. There are six levels of status, each 
of which is described below: 


Status 1: Task image is on the disk. If its partition is available, 
flag partition unavailable and proceed to status two; 
otherwise, service next Task in ATL. 

Status 2: Task image is on the disk and the partition is available for 
its use. Queue disk read request with Event Variable in ATL 
(Word 11) and proceed to status three. 

Status 3: Waiting for an Event Variable. If the Event Variable, whose 
address is in the ATL, is non- zero, proceed to status four; 
otherwise service next Task in the ATL. 


Status 4: Task is ready to be started or resumed. In order that its 

environment will be saved if it is interrupted by the Execu- 
tive, set status five, and start or continue Task execution. 
(Status four may be set by the WAIT or RESUME Directives.) 

Status 5: Task has been interrupted by the Executive (environment saved 
in partition block) . Restore environment and return control 
to Task, 

Status 6: Task has been suspended. (Status six is set only by the 
SUSPEND Directive.) 


lAA THE CLOCK QUEUE 

The Clock Queue is a deque consisting of one node for each item to be 
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done at some time in the future. These items are: scheduling of T^sks 

(SCHEDULE, RUN, and SYNC Directives), rescheduling of Tasks (Clock 

interrupt service routine) , and setting of Event Variables after 

elapsed time periods (MARK Directive) . The nodes are linked in the 

order in which they come due, and have the following format: 

Word 0 — Forward Pointer 

Word 1 — Backward pointer 

Word 2 — Type indicator (TS,MT) 

Word 3 — Unused 

Word 4 — Run priority (TS) or Event Variable address (MT) 

Word 5 — STL node address (TS) or zero (MT) 

Word 6 — Schedule interval seconds (TS,MT) 

Word 7 — Schedule interval ticks (TS,MT) 

Word 10 — Reschedule interval seconds (TS) 

Word 11 — Reschedule interval ticks (TS) 

TS — Task Scheduling usage 
MT — Mark Time usage 

Word 2, the Type indicator, is set as follows: 

0 — Task scheduling with no rescheduling 

1 — Task scheduling with periodic rescheduling 

5 — Mark time request 

6 — Null node (result of cancellation) 

The schedule interval in all nodes, except the first node, is relative 
to the previous node. The schedule interval in the first node is 
relative to "now" and is decremented and examined at each clock tick. 
Two words are used to record the schedule interval: "schedule ticks" 
and "schedule seconds". The schedule ticks is only zero when a node 
is to come due at the same time as the previous node and is never 
greater than the number of ticks per second. When an interval of more 
than one second is represented, the schedule seconds indicates the 
number of additional whole seconds. The "reschedule ticks" and 
"reschedule seconds" are the schedule interval reset values when 
periodic Task rescheduling has been requested. 


7.^.5 THE PARTITION BLOCKS DESCRIPTION LIST (PBDL) 

Partition Blocks serve three functions: (1) They contain partition 
description information to assure that a Task being installed into the 
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system has been built for an existent partition; (2) they provide core 
for an Event Variable and disk GET (DSKGET) control table necessary to 
load Tasks into partitions; and (3) they provide for saving a Task's 
environment when it is interrupted by the Executive. The Partition 
Blocks are generated by the System Configurator and are linked together 
into a deque called the Partition Blocks Description List with abnormal 
nodes having the following format: 


Word 

0 

Word 

1 

Word 

2 

Word 

3 

Word 

4 

Word 

5 

Word 

6 

Word 

7 

Word 

10 

Word 

11 

Word 

12 

Word 

13 

Word 

14 

Word 

15 

Word 

16 

Word 

17 

Word 

20 

Word 

21 

Word 

22 

Word 

23 

Word 

24 

Word 

25 

Word 

26 

Word 

27 

Word 

30 

Word 

31 

Word 

32 

Word 

33 


Forward pointer 
Backward pointer 

Partition name (first half .SIXBT) 

Partition name (second half .SIXBT) 

Partition base (address) 

Partition size 

Flags word (bit 0 indicates partition is occupied) 
Register save routine entry point (operand address for 


wd. 12) 

Interrupt connect location (JMS here upon interrupt) 
DBA instruction 

JMS* .-3 instruction (transfer to save routine) 

AC buffer 
XR buffer 
LR buffer 


MQ 

SC 

R1 

R2 

R3 

R4 

R5 

R6 

XIO 


buffer 

buffer 

buffer 

buffer 

buffer 

buffer 

buffer 

buffer 

buffer 


Xll buffer 
X12 buffer 
X13 buffer 
L20 buffer 
SKP 


(Words 15 thru 21 are used by 
the Executive during status two 
and three to store the disk read 
Event Variable and Control 
Table) 

(R1 thru R6 are pseudo registers 
used by re-entrant system 
routines) 

(XlO thru X13 are autoincrement 
registers 10 thru 13) 


(CAL return parameters) 

SKP is an indicator to the 
register save routine to trans- 
fer control to the Executive 
(NOP indicates transfer to an 
interrupt service routine) . 


7,H,6 THE PHYSICAL DEVICE LIST (PDVL) 

When a logical I/O unit is assigned to a physical unit, the address 
of a node describing the device and unit is set in a logical unit table 
entry corresponding to the Logical Unit N\amber (LUN) . These nodes are 
constructed by the System Configurator and linked together into a deque 
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called the Physical Device List. Each PDVL node has the following 
format: 

Word 0 — Forward pointer 

Word 1 — Backward pointer 

Word 2 — Device ncune (first half .SIXBT) 

Word 3 — Device name (second half /always zero) 

Word 4 — Device Attach flag 

Word 5 — Unit number 

Word 6 — Device request queue (deque listhead) forward pointer 

Word 7 — Device request queue (deque listhead) backward pointer 

Word 10 — Trigger Event Variable address 
Word 11 — Assign inhibit flag 


7.4.7 THE SYSTEM COMMON BLOCK DEFINITION LIST (SCDL) 


The System COMMON Block Definition List (SCDL) is a deque built by the 

System Configurator consisting of a description of each COMMON Block 

in the System, An SCDL node has the following format: 

Word 0 — Forward pointer 
Word 1 — Backward pointer 

Word 2 — COMMON Block ncune (first half .SIXBT) 

Word 3 — COMMON Block name (second half .SIXBT) 

Word 4 — Unused 

Word 5 — Base of COMMON Block (address) 

Word 6 — Size of COMMON Block 
Word 7 — Unused 
Word 10 — Unused 
Word 11 — Unused 


7.5 INPUT/OUTPUT OPERATIONS 

Input/Output operations in the RSX System are device independent, with 
I/O requests being made to Logical Device Units rather than Physical 
Device Units. Logical Units are equivalenced to Physical Device Units 
via a Logical Unit Table (LUT) . The LUT is a block of contiguous core 
with a one word entry, or slot, for each LUN. LUN slots are designated 
sequentially from one and will contain a zero if unassigned (assigned 
to NONE) . The LUT is maintained by the REASSIGN MCR Function. 

Physical Device Units are represented by nodes in a deque called the 
Physical Device List (PDVL) , When a LUN is assigned to a Physical 
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Device Unit, the corresponding LUT slot contains the address of the 
appropriate Physical Device List node. Corresponding to the LUT is an 
Attach-Flag-Table (AFT) with a two word entry for each LUT slot. 
Whenever a LUN is attached to a Task , the Task name is set in the 
corresponding AFT slot. Whenever a LUN and Device Unit are both 
attached to a Task, the Device attach flag in the PDVL points to the 
appropriate AFT slot. 

7.5.1 I/O HANDLER TASK INITIALIZATION 

All I/O Handlers are RSX Tasks and are called I/O Handler Tasks 
(IOHT*s). They differ from most other Tasks in that they contain an 
interrupt service routine and that a naming convention exists.* 

When a LUN is assigned to a Physical Unit, the appropriate I/O Handler 
Task is REQUESTed (by the REASSIGN MCR Function) . The Handler Task 
then initializes itself and instructs the system (using the WAITFOR 
Directive) to suspend its execution until its Trigger Event Variable 
is set. Handler Task initialization consists of CONNECTing to an 
interrupt line and setting the address of the Task ' s Trigger Event 
Variable in the corresponding Physical Device List node(s). 

A Handler Task normally services all Units of a Device. 

7.5.2 I/O REQUESTS 

I/O requests are made using the QUEUE I/O Directive. This Directive 
expects to find a PDVL node address in the LUT slot indicated by the 
LUN, and a Trigger Event Variable address in the PDVL node. If the 
LUT slot contains a zero, the request is rejected because the LUN has 
not been assigned to a Physical Unit. If the Trigger Event Variable 
address is zero, the request is rejected because the Hemdler Task has 
not yet been initialized. If the LUT slot and Trigger Event Varieible 


* See section 8.5 
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address have been set, a request node is formed and inserted into a 
request queue, and the Handler Task is "triggered" by setting the 
Trigger Event VarieUale and declaring a Significant Event. If a 
Handler Task is triggered while it is servicing a request, the trigger 
is ignored; however, if a Handler Task is idle, the trigger will bring 
it back into service. 

There are separate I/O request queues for each Physical Device Unit. 
These queues are deques with their listheads in the PDVL nodes for the 
physical units. Requests are normally serviced in order of priority 
by simply picking up the front node from the request queue. I/O 
requests are processed at API level 7 and are de-queued by priority of 
the requestor (software priority 1-512) with the highest priority 
request at the front of the deque. Requests of equal priority are 
inserted in the order that the requests were made. 

If a Physical Device Unit is ATTACHed, only requests from the Task 
that issued the ATTACH will be serviced, however, I/O requests from 
all Tasks are queued. When the DETACH request is serviced, pending 
I/O requests from other Tasks in the queue will then be serviced. 

The QUEUE I/O Directive allows an I/O requestor to specify an Event 

Variable to be set to indicate the status of a request. If a request 

cannot be queued, the requestor's Event Variable is set to one of the 

following negative values: 

-101 — Illegal (out of range) LUN 
-102 — LUN not assigned to a physical unit 
-103 — Handler not resident and initialized 
-777 — Request node not available (pool empty) 

If a request is queued, the requestor's Event Variable is zeroed to 

indicate that the request is pending and the Handler Task will set it 

non-zero. If a Handler Task cannot successfully complete a request, 

it will set the requestor's Event Variable to a negative value, (See 

Appendix D for a complete list of returned Event Variables. 
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When an I/O request is successfully completed, the requestor's Event 
Variable is set positive, normally to one (+1). 


7.5.3 I/O FUNCTIONS 


The following is a description of CAL Parameter Block operands for 
the QUEUE I/O Directive. The FUNCTION CODE WORD contains the CAL 
Function Code for the QUEUE I/O Directive (jJ0) in bits 12-17 and the 
I/O Function code in bits 3-11. An Event Variable address of zero 
implies "no Event Variable specified". ALLOCATE, DEALLOCATE, GET, and 
PUT are device dependent functions, and the address of a table of con- 
trol information is a part of the request, i.e., the Control Table is 
not queued. 


ALLOCATE (4 words) 

FUNCTION CODE WORD (1500) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
CONTROL TABLE ADDRESS 

DEALLOCATE (4 words) 

FUNCTION CODE WORD (1600) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
CONTROL TABLE ADDRESS 

ATTACH (3 words) 

FUNCTION CODE WORD (2400) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 

DETACH (3 words) 

FUNCTION CODE WORD (2500) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 

READ (6 words) 

FUNCTION CODE WORD (2600) 

EVENT VARIABLE ADDRESS 

LOGICAL UNIT NUMBER 

DATA MODE INDICATOR 

CORE BUFFER ADDRESS 

BUFFER SIZE (max words transferred) 

WRITE (5 words) 

FUNCTION CODE WORD (2700) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
DATA MODE INDICATOR 
CORE BUFFER ADDRESS 
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GET (4 words) 

FUNCTION CODE WORD (3000) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
CONTROL TABLE ADDRESS 

PUT ( 4 words ) 

FUNCTION CODE WORD (3100) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
CONTROL TABLE ADDRESS 

SEEK ( 6 words ) 

FUNCTION CODE WORD (3200) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
FILE NAME (first half) 

FILE NAME (second half) 

FILE NAME EXTENSION 

ENTER (6 words) 

FUNCTION CODE WORD (3300) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
FILE NAME (first half) 

FILE NAME (second half) 

FILE NAME EXTENSION 

CLOSE ( 3 words ) 

FUNCTION CODE WORD (3400) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 

DELETE (6 words) 

FUNCTION CODE WORD (3500) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 
FILE NAME (first half) 

FILE NAME (second half) 

FILE NAME EXTENSION 

HINF (3 words) 

FUNCTION CODE WORD (3600) 

EVENT VARIABLE ADDRESS 
LOGICAL UNIT NUMBER 

The following Control Table formats are expected by the Disk Driver 

ALLOCATE (3 words) 

REQUIRED STORAGE (IN WORDS) 

DISK UNIT* 

TRACK & HEAD* 


* Set by the Disk I/O Handler, not the requestor. 
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DEALLOCATE (3 words) 

STORAGE ALLOCATED 
DISK UNIT 
TRACK & HEAD 

GET ( 4 words ) 

DISK UNIT 
TRACK & HEAD 
CORE ADDRESS 
WORD COUNT 

PUT (4 words) 

DISK UNIT 
TRACK & HEAD 
CORE ADDRESS 
WORD COUNT 


7.5.^ HANDLER TASK EXIT 


When there are no Logical Unit Numbers assigned to a physical device, 
the REASSIGN MCR Function sets the "assign inhibit flag" and clears 
the Trigger Event Variable address in the Physical Device List node 
for each unit of the device and inserts an EXIT request in the I/O 
queue for one of the device's units. The Handler Task services the 
EXIT request by: 1) DISCONNECTing from an interrupt line, 2) clearing 
the assign inhibit flag, and 3) EXITing. 


7.5.5 DISK STRUCTURE 


A disk unit (platter) in the RSX System contains a total of 262,144 
decimal words which is divided into 2048 decimal blocks of 128 decimal 
words each for purposes of storage allocation. The disk is word ad- 
dressed)le for data transfer purposes. Recorded on each disk platter 
is a bit map that indicates which areas of the disk are free (to be 
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maps are initialized (cleared) by the System Configurator indicating 
that all blocks* are free. Bit maps consist of 128 decimal words 


* 


Excluding one bit map block per platter and save area on platter zero 



(1 disk block) beginning at location 7776002 on each platter. Each 
word in the bit map represents 16 decimal consecutive blocks. Bits 
16 & 17 of the PDF- 15 word are unused. A 0-bit indicates a block is 
free and a 1-bit indicates it is occupied. 

Since there may exist up to 8 disk platters, it is possible for an 
ALLOCATE request to require 9 disk transfers (approximately 300 milli- 
seconds) . To prevent holding off high priority disk requests for this 
length of time, the Disk handler consists of two Tasks: "DSK", the 
Disk Driver, and "DSA", a lower priority Task that handles Disk 
ALLOCATE/DEALLOCATE requests. Whenever "DSK" encounters an ALLOCATE 
or DEALLOCATE request in its I/O request queue, it simply moves the 
request node from its own queue to another queue belonging to "DSA" , 
Then it sets "DSA's" trigger event variable and declares a significant 
event so that "DSA" will run ("DSA" runs at a priority level lower than 
"DSK") . 


7.5.6 I/O DATA MODES 


The following I/O data modes are supported in the RSX System; 


lOPS BINARY (mode 0) 

IMAGE BINARY (mode 1) 

lOPS ASCII (mode 2) 

IMAGE ASCII (mode 3) 

The data modes, including line buffer construction, have identical 
meanings to those used in the ADVANCED Software System (see PDP-15 
ADVANCED Software System Monitors Manual section 2.2 and 2.3). 


I/O Handler Tasks provided by DEC are listed below along with the data 

modes each is capable of handling: 

DT — All 
DK — None* 


* Data modes do not apply to the GET and Put functions. 
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LP — lOPS ASCII & IMAGE ASCII 

TT — lOPS ASCII & IMAGE ASCII 

PP — All 

PR — All 

7.5.7 INTERRUPT PROCESSING 

Interrupt processing under the RSX System consists of hardware inter- 
rupts having various levels of priorities. The hardware interrupts 
normally suspend the execution of other functions in the System in- 
cluding the Executive; however, the Executive delays the servicing of 
hardware interrupts while it is completing internal operations which 
cannot be interrupted. These operations are always short in duration 
and involve the updating of the various lists of system information 
maintained by the Executive. This delay is never greater than 30 usees. 

Real-Time programs connect themselves to hardware interrupt lines with 
the use of System Directives; and when hardware interrupts occur on 
those lines, control is transferred by the hardware (API) directly to 
the interrupt service routines. Once an interrupt service routine has 
been entered, it can either save its active registers or use the 
Executive's Register Save and Restore routines to preserve the contents 
of the active system registers. The user, however, might or might not 
decide to save the registers of an interrupted Task depending on timing 
constraints. Some cases may only require the saving of the Accumu- 

lator (AC) which would be done by the interrupt service routine itself. 
The Executive ' s Save and Restore routines , however , save and restore 
several system registers including the Accumulator, Link, MQ, first 
four Autoincrement, Limit, and Index Registers. The decision 
whether or not to use the Executive ' s Save and Restore routines depends 
on two considerations. First, can the interrupt service routine 
tolerate delays incurred by using these routines (each operation re- 
quires about 7J2f usees). Second, how many of the system's active 
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registers are used by the interrupt service routine? 


To illustrate the different methods the user can use for saving and 
restoring system registers, two exeunples are given. Excunple one 
illustrates an interrupt service routine which only requires saving 
the Accumulator, and exaimple two illustrates the use of the Executive ' s 
Save and Restore routines when several registers are required in the 
interrupt service routine. 

Example 1: Assume the interrupt service routine requires only the 
Accumulator and does not desire to use the Executive's 
routines because of timing constraints. The interrupt 
service routine could be structured as follows: 


SERDEV 0 /ENTRY POINT TO ROUTINE 


DBA 


/ENTER PAGE ADDRESSING 

MODE 

DAC 

SAVEAC 

/SAVE ACCUMULATOR 


, 

• 

/REAL-TIME PROGRAM EXECUTES AT HARDWARE 

• 

• 

/ PRIORITY LEVEL. 


LAC 

SAVEAC 

/RESTORE ACCUMULATOR 


DBR 


/DEBREAK FROM HARDWARE 

LEVEL 

JMP5« 

SERDEV 

/RETURN TO INTERRUPTED 

TASK 

SAVEAC 0 


/TEMPORARY STORAGE FOR 

ACCUMULATOR 


Example 2: Assume the interrupt service routine requires several 

system registers and desires the use of the Executive's 
Save and Restore routines. 


INTENTRY SERDEV /ENTRY POINT TO ROUTINE. INTENTRY IS A 

. / SYSTEM MACRO TO CALL THE EXECUTIVE'S 

/ SAVE ROUTINE. 

/BODY OF INTERRUPT SERVICE ROUTINE 


7-16 



INTEXIT SERDEV /INTEXIT IS A SYSTEM MACRO TO CALL THE 

/ EXECUTIVE'S RESTORE ROUTINE, DEBREAK 

/ FROM HARDWARE LEVEL, AND RETURN TO 

/ INTERRUPTED TASK. 

Interrupt service routines are an integral part of a Task and must be 
connected to and disconnected from hardware interrupt lines before use. 
That is, before a Task can process hardware interrupts the Task must 
first connect itself to a particular API line. Likewise, when a Task 
no longer requires the use of an interrupt line it should disconnect 
and release it to the system. Note that even though several Tasks can 
connect and disconnect themselves to the same API line, only one Task 
can be connected to it at any given time. The following example 
illustrates an interrupt service routine that uses the System Direc- 
tives CONNECT and DISCONNECT to connect and disconnect itself from an 
interrupt line. 

Example 3: 


/CODE TO INITIALIZE A TASK 

• 

. /CONNECT INTERRUPT SERVICE ROUTINE, 

CONNECT SERDEV, 26, EV/ SERDEV, TO INTERRUPT LINE 26. 

/THE VALUE OF EV, THE EVENT VARIABLE, 

/ SHOULD BE TESTED TO INSURE THE 

. / CONNECTION WAS MADE. 

INTENTRY SERDEV /ENTRY POINT TO INTERRUPT ROUTINE, SAVE 

/ ACTIVE REGISTERS. 

. /BODY OF INTERRUPT SERVICE ROUTINE 


INTEXIT SERDEV /RESTORE SAVED REGISTERS, DEBREAK FROM 

/ HARDWARE LEVEL, AND RETURN TO IN- 

. / TERRUPTED TASK. 

. /MAIN PORTION OF TASK WHICH OPERATES AT 

/ TASK PRIORITY LEVEL. 

DISCONNECT SERDEV, 26, EV/DISCONNECT INTERRUPT SERVICE ROUTINE 

/ FROM LINE 26. 

EXIT /END OF TASK 
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CHAPTER EIGHT 
TASK CONSTRUCTION 


8.1 INTRODUCTION 

Task construction in the RSX environment falls into one of four dis 
tinct categories; (1) a Task which includes computation and/or re- 
quests to I/O Handler Tasks? (2) an MCR Function Task; (3) a Front- 
End Interrupt Driver Task; and (4) an I/O Handler Task. All Tasks, 
regardless of priority, must be built with the Task Builder before 
installing into the RSX System. 


When building Tasks, the following conventions must be adhered to for 
successful operation of the RSX System; 

(1) All hardware registers are available to the prograunmer except 
the last 4 Autoincrement Registers (14-17) which are used by 
the system. 

(2) A naming convention exists for Tasks in categories 2 and 4 
(see sections 8.2 and 8.4, respectively). 

(3) Tasks should not EXIT while I/O, Mark Time, or Event 
Variable settings are still pending since the Task may be 
overlayed by another Task before the operation has completed. 

(4) All Directives (viz., the issuing of the CAL instruction) 
result in a loss of the original contents of the following 
registers; AC, XR, LR, MQ, LINK, SC, Autoincrement Registers 
10-13, system registers R1-R6, and location 20. Unexpected 
interrupts which suspend normal Task execution always save 
and restore active registers before use. 

The following sections describe the different Task categories in 
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greater detail. 


8.2 COMPUTATIONAL TASK 

The computational Task is the more common type of user written Task 
since it includes progreims written in FORTRAN and assembly language 
which do not have interrupt routines and I/O drivers internal to the 
Task. All necessary Input/Output is referenced through LUN slots. 

Computational Tasks require no naming conventions except the name 
must be 1-6 characters in length (Tasks called by FORTRAN programs 
must be 1-5 characters in length) . 

8.3 MCR FUNCTION TASK 

The Monitor Console Routine (MCR) consists of a resident Task called 
the Resident MCR Task, and a set of MCR Function Tasks. The Resident 
MCR Task reads a line of input from LUN 2 and REQUESTS the appropriate 
MCR Function Task which performs the MCR function. 

MCR Functions normally all share the seune core partition dedicated to 
MCR Functions, however, they may be "built" to run in any partition. 
The name of the Resident MCR is "...MCR" and the name of an MCR 
Function is three periods followed by the first three characters 
of the name of the MCR Function (e.g., the TIME MCR Function is 
named " . . .TIM" ) . 

The Resident MCR Task is REQUESTed either by the Teletype Handler Task 
in response to a CTRL C (from LUN 2) or by an MCR Function Task. 

Two subroutines, with entry points in the System Communications (SCOM) 
area, are used by both Resident MCR and MCR Function Tasks. One (FAC) 
is used to Fetch-A -Character from a line of command input, and the 
other (IFAC) to Initialize the Fetch-A-Character subroutine by 
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reading a line of command and setting the appropriate pointers. 

Before reading a line, "MCR>“ is output (on LUN-2) to indicate that 
the MCR is waiting for input. 

The name of an MCR Function Task is formed by reading a line of command 
input (IFAC) , fetching the first three characters (FAC) , and preceding 
them with three periods. After forming the MCR Function Task Name, 
the Resident MCR Task continues to fetch characters until either a 
SPACE, COMMA, CAR RTN, or ALTMODE is found. This is done so that only 
as few as the first three characters of an MCR Function need be input. 
After "flushing thru the first break character", the MCR Function 
Task is REQUESTed and the Resident MCR Task EXIT'S. If more informa- 
tion is contained in the first line of input, it will be read by the 
Function Task using the FAC subroutine. If additional lines of input 
are required by the Function Task, they are read using the IFAC and 
FAC subroutines. 

Also included in the SCOM area is the MCR Request Inhibit flag (MCRRI) 
which is examined and set by both the Teletype Handler Task and MCR 
Function Tasks. If MCRRI=0 and a CTRL C is typed in, the Teletype 
Handler Task will REQUEST ...MCR and set MCRRI*1. If MCRRI^^O and a 
CTRL C is typed in, the Teletype Handler Task will set MCRRI»-1. 

MCRRI is cleared by MCR Function Tasks, normally just before they exit, 
or at least after they have finished fetching characters from the 
input line. MCRRI is set negative whenever a CTRL C does not result 
in REQUESTing ...MCR so that CTRL C may also be used to imply 
"premature termination" to an MCR Function with lengthy output. 

When an MCR Function has been performed, and the first line of command 
input (the line read by the Resident MCR) has been terminated by a 
CAR RTN, the Resident MCR Task is REQUESTed by the MCR Function Task. 
When the first line of command input is terminated by an ALTMODE, the 
Resident MCR Task is not REQUESTed at the completion of an MCR 
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Function, and a CTRL C typein is necessary to re-estciblish MCR 
dialogue. 

The MCR Function Tasks are normal Tasks that adhere to the above 
conventions related to REQUESTing the Resident MCR Task. A user may 
build his own MCR Function Tasks and is restricted only in naming it 
(the name must start with three dots) . 

The following example illustrates the structure of a typical MCR 
Function Task (TIME MCR Function) . Note that the section between line 
numbers 73-78 (cross-reference line numbers) shows the standard EXIT 
procedure from an MCR Task . 
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PAGE 1 


TIM. 5 SRC 


1 

2 

3 

4 

5 

6 

7 

8 
9 

310 

11 

12 

13 

14 

15 

16 


20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 


/ EDIT #5 
/ 

/ COPYRIGHT 1970, DIGITAL LQUIPmENT CORP,. MAYNARDi MASS, 

/ 

/ MCR FUNCTIONI TIME 25 mAR 7 I R, MCLE'AM 

/ 

/ TASK NAMEJ ",.,TIM« T^ TYPE LUM«3 TIME ON THE 
/ IN RESPONSE TO THE MCR "TIME” REQUEST, 

/ 

/ THE FIRST LINE OF COMMANU INPUT FOR ANY McR FUNCTION IS READ 
/ BY THE resident MCR TASK FOR THE ”TIME" FUNCTION, 

/ THE SYNTAX OF THE FIRST LINE ISI 
/ 

f SYNTAX s »»TIM"$<CHARACTer> <cR>/<AM> 

/ <character> = <LETTer>/<DIGIT> 

/ <CR> S CAR RTN 

/ <AM> s ALTMODE 

f % "Any number of, including hero" 

/ 

/ the resident mcR reads a line, Fetches the first three characters 
/ to from the MCR function TASK mAhE FLUSHES CHARACTERS 

/ thru the First break or terminal char, requests "...tim" and exits, 

/ 

/ LINE terminator, no DATA IS TAKEN FROM THE COMMAND INPUT I INE, 

/ the task ",,,TIM" FLUSHES ALL CHARACTERS THRU THE END OF THE INPUT LINE, 
/ and saves the line terminator, no data is TAKEN FROM THE INPUT LINE, 

/ 

/ the time Is typed out HHHtMMjsS” 

/ 

/ IF THE INPUT LINE IS TERMINATED BY A CAR RTN, THE RESIDENT MCR 

/ IS requested, and the function Task exits, 

/ IF THE INPUT LINE IS TERMINATED BY AN ALTMOOE, THE FUNCTION 

/ task (",.,tim") Exits without reque,, sting the resident mcr, 

/ A tc TYPEIN IS NECESSARY TO RE^LSTABUSH HCR DIALOGUE, 



PAGE 2 

TIM.S 

! 

SRC 

• «« 

MCR FUNCTION 

»TImE» 



36 





,T1TEE 1 

HCR FUNCTION 

1 »time» 


37 





/ 




38 



000163 

A 

SS«163 




39 



000164 

A 

MH«164 




40 



000165 

A 

HH»165 




41 



000171 

A 

MCRRI-171 




42 



000174 

A 

FACal74 




43 





/ 




44 



705522 

A 

,INH*705522 

/INHIBIT 

' interrupts 


45 



705521 

A 

,ENB«705521 

/ENABLE 

interrupts 


46 





/ 




47 

00000 

R 

120113 

R 

TIME JMS« 

(FAC) 

/FLUSH input thru TERMINATOR# 

48 

00001 

R 

540114 

R 

SAO 

(015) 



49 

00002 

R 

600006 

R 

JMP 

tIM3 



50 

00003 

R 

540115 

R 

SAO 

(175) 



51 

00004 

R 

600006 

R 

JMP 

TIM3 



52 

00005 

R 

600000 

R 

JMP 

time 



53 

00006 

R 

040034 

R 

TIM3 OAC 

term 



54 





/ 




55 

00007 

R 

705522 

A 

.INH 


///fetch TIME 


56 

00010 

R 

220116 

R 

lAO<^ 

(HH) 

/// 


57 

00011 

R 

040101 

R 

OAC 

MHN 

/// 


58 

00012 

R 

220117 

R 

lAC* 

(MM) 

/// 


59 

00013 

R 

040104 

R 

OAC 

mmm 

/// 


60 

00014 

R 

705521 

A 

,ENB 


/// 


61 

00015 

R 

220120 

R 

UAC* 

(SS) 

/// 


62 

00016 

R 

040107 

R 

OAC 

MSS 



63 





/ 




64 

00017 

R 

200121 

R 

UAC 

(MHH) 

/CONVERT Time to 

DECIMAL AND 

65 

00020 

R 

040067 

R 

OAC 

CONX 

/STORE IN IMAGE 

ALPHA BUFFER 

66 

00021 

R 

100044 

R 

JMS 

CON 



67 

00022 

R 

100044 

R 

JMS 

CON 



68 

00023 

R 

100044 

R 

JMS 

CON 



69 





/ 




70 

00024 

R 

000071 

R 

CAU 

TVPCP0 

/ttpe Time 


71 

00025 

R 

000035 

R 

CAL 

waitlp 

/WAIT For tty to 

FINISH 

72 





/ 
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73 

00026 

R 

200034 

R 

EXIT 

LAC 

term 

74 

00027 

R 

540114 

R 


SAD 

(015) 

75 

00030 

R 

000037 

R 


CAL 

reqmcr 

76 

00031 

R 

540115 

R 


SAD 

(175) 

77 

00032 

R 

160122 

R 


02M« 

(MCRRl 

78 

00033 

R 

000123 

R 


CAL 

110) 

79 





/ 



80 

00034 

R 

000000 

A 

TERM 

0 


81 





/ 



82 

00035 

R 

000020 

A 

waitlp 

20 


83 

00036 

R 

000076 

R 


typev 

/EVENT 

84 





/ 



88 

00037 

R 

000001 

A 

REQMCR 

1 


86 

00040 

R 

000000 

A 


0 


87 

00041 

R 

565656 

A 


.SlXgT 

” , , , ” 

88 

00042 

R 

150322 

A 


,sixbt 

»*MCR” 

89 

00043 

R 

000000 

A 


0 


90 





/ CON 

subroutine to 


CAR RThj terminated INPUT LINE, REQUEST 

/resident MCR task & EXIT, IF AlTMOnE TERMINATED 
/INPUT line, clear *C REQUEST INHIBIT FLAG 

/and exit, 


variable address 
/request ”„,.MCR’' cpb 


CONVERT AN iNTEGER TO ITS TWO DIGIT 


PACE 3 TIM, 5 SRC 


»»* MCR FUNCTION »TImE» 


n 

n 

93 

94 


95 

96 

97 

98 


99 

100 

XH 

A02 

103 

104 

105 

106 
107 


/ decimal equivalent <IMAGE alpha), ’CONX’ POINTS TO THE 
/ binary word, the binary word is replaced by THE TENS 

/ DIGIT and the units DIGIT IS STORED IN THE FOLLOWING WORD, 

/ »CONX» IS incremented by three, 

/ 


00044 

R 

000000 

A 

CON 

0 


00045 

R 

220067 

R 


UAC* 

CONX 

00046 

R 

160067 

R 


OHM* 

CONX 

00047 

R 

040070 

R 

CONI 

DAC 

CONB 

00050 

R 

723766 

A 


A AC 

f.12 

00051 

R 

741100 

A 


SPA 


00052 

R 

600055 

R 


UMP 

CON2 

000153 

R 

460067 

R 


ISH* 

CONX 

00054 

R 

600047 

R 


JMP 

CONI 

00055 

R 

220067 

R 

C0N2 

LAC* 

CONX 

00056 

R 

240124 

R 


XOR 

(60) 

00057 

R 

060067 

R 


DAC# 

CONX 



X08 

00060 

R 

440067 

R 



ISZ 

CQNX 

109 

00061 

R 

200070 

R 



LAC 

CONB 

110 

00062 

R 

240124 

R 



XOR 

(60) 

111 

00063 

R 

060067 

R 



OAC* 

CONX 

112 

00064 

R 

440067 

R 



ISH 

CONX 

113 

00065 

R 

440067 

R 



1S2 

CONX 

114 

00066 

R 

620044 

R 



JMP« 

CON 

115 






/ 



116 

00067 

R 

000000 

A 


CONIX 

0 


117 

00070 

R 

000000 

A 


CONB 

0 


118 






/ 



119 

00071 

R 

002700 

A 


TYPCPB 

2700 

/FUNCTION 

120 

00072 

R 

000076 

R 



typCv 

/EV ADR 

121 

00073 

R 

000003 

A 



3 

/LUN 

122 

00074 

R 

000003 

A 



3 

/MODE 

123 

00075 

R 

000077 

R 



MES12 

/BUFFFER APR 

124 






/ 



125 

00076 

R 

000000 

A 


TYPEV 

0 

/EVENT variable 

126 






/ 



127 

00077 

R 

006003 

A 


MES12 

006003 

/HEADER 

128 

00100 

R 

000000 

A 



000000 


129 

00101 

R 

000000 

A 


MHH 

000 

/HOURS 

130 

00102 

R 

000000 

A 



000 


131 

00103 

R 

000072 

A 



072 

/COLON 

132 

00104 

R 

000000 

A 


mmm 

000 

/minutes 

133 

00105 

R 

000000 

A 



000 


134 

00106 

R 

000072 

A 



072 


135 

00107 

R 

000000 

A 


MSS 

000 

/SECONDS 

136 

00110 

R 

000000 

A 



000 


137 

00111 

R 

000015 

A 



015 

/C« 

138 

00112 

R 

000012 

A 



012 

/UF 

139 









140 



000000 

R 



.END 

TIME 


00113 

R 

000174 

A 






00114 

R 

000015 

A 

•L 





00115 

R 

000175 

A 

•L 





00116 

R 

000165 

A 

*1. 





00117 

R 

000164 

A 

*L 






PAGE 


TIM. 5 

SRC 

mcr function »TIhE’ 

00120 R 

000163 

A 

*L 

00121 R 

000101 

R 


00122 R 

000171 

A 

•L 

00123 R 

000010 

A 

*U 

00124 R 

000060 

A 

*L 

SIZE 

>00125 


NO ERROR LINES 


PAGE 5 TIM„5 CROSS REFERENCE 


CON 

00044 

66 

67 

68 

96# 

114 



CONB 

00070 

99 

109 

ll7# 





CONX 

00067 

65 

97 

98 

103 

105 

107 

108 



113 

116# 






CONI 

00047 

99# 

104 






C0N2 

00055 

102 

105# 






EXIT 

00026 

73# 







FAC 

000174 

42# 

47 






HH 

000165 

40# 

56 






MCRRI 

000171 

41# 

77 






MES12 

00077 

123 

127# 






MHH 

00101 

57 

64 

129# 





MM 

000164 

39# 

58 






MMM 

00104 

59 

132# 






MSS 

00107 

62 

135# 






REQMCR 

00037 

75 

85# 






SS 

000163 

38# 

61 






TERM 

00034 

53 

73 

80# 





TIME 

00000 

47# 

52 

140 





TIM3 

00006 

49 

51 

53# 





TYPCPB 

00071 

70 

119# 






TYPEV 

00076 

83 

120 

125# 





WAITLP 

00035 

71 

82# 






,enb 

705521 

45# 

60 






.INH 

705522 

44* 

55 







1 3. 1 1 1 2 



8.4 FROMT-END DEVICE DRIVER TASK 


The Front-End Interrupt Driver Task is a Task which has both computa- 


txonaX and xnterrupt processxn^^ ca{jabiXities* UnXike the Computational 


Task, the Front-End Task has an internaX interrupt routine; but it does 
not require the QUEUE I/O Directive to control it as do I/O Handier 
Tasks. 


An exampXe Front-End Task used to generate straight Xine vectors on 
the VPX5 storage scope is given at the end of this section (VP. 6). 
This particuXar Task is a subroutine with four entry points for 
CONNECTing and DISCONNECTing from the interrupt Xine, erasing the 
dispXay, and pXotting a straight Xine vector. 


The foXXowing paragraphs describe the separate sections of the VP. 6 
Task. 

Line Numbers * LabeX Description 

25-3X CINT Connect dispXay interrupt 

routine, VPINT, to interrupt 
Xine X4. Notice that if the 
Event VariabXe (EV) is negative, 
the Task EXITS since the connec- 
tion couXd not be made. If a 
successful connection is made, 
the EV is cleared before return- 
to the caXXer. 


4^f-47 


5X-54 


DINT Disconnect dispXay interrupt 

routine, VPINT, from interrupt 
Xine X4. The testing of the EV 
is not required here; hence, the 
address of EV in the CAL Param- 
eter BXock, Xine number 45, is 
zero. 

ERASE Erase the face of the storage 

scope. This operation (EST) 
generates an interrupt once the 
dispXay has been erased and re- 
quires waiting tiXX compXetion. 
This is done by issuing a 
WAITFOR EV from routine WDINT 


*Line Numbers (decimal) along the left hand column of the VP. 6 Task 
listing . 
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58-171 


173-176 


181-189 


(line 175) . The interrupt 
routine, VPINT, clears the dis- 
play flag when the erase opera- 
tion has completed, sets the EV, 
and declares a Significant Event 
(Request API level 6) . This 
results in a scan of the Active 
Task list and a return following 
the WAITFOR (contingent upon 
priority) . 

VECTOR This is the straight line vector 
plot routine which calculates 
the required points to generate 
the line and displays them one 
point at a time. Following each 
point displayed, a WAITFOR is 
done to wait for the completion 
of the displayed point (line 143 
and 172). 

WFINT Subroutine to issue a WAITFOR EV 

Directive until the point or 
erase operation has completed. 

It then clears the EV before re- 
turning. (If the EV wasn't 
cleared, the next WAITFOR EV 
issued would return immediately 
since the EV is set.) 

VPINT Display interrupt service 

routine which sets the EV signi- 
fying the operation is complete 
and declares a Significant Event 
(Request API level 6) . The dis- 
play flag is cleared and control 
returned to the interrupted Task. 
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/ EDiir #6 
/ 

/ ERASE & VECTOR — FORTRAN CALLABLE SUBROUTINE TO ERASE 
/ SCOPE, OR TO CONSTRUCT A VECTqR FROM Pl(lXl,lYt) TO P2 


/CALLING SEQUENCES! 


7 





/ 

CALL 

cint 

8 





/ 

CALL 

dint 

9 





/ 

CALL 

ERASE 

10 





/ 

CALL 

vector 

11 





/ 



12 





/ 



13 



700504 

A 

LXB = 

700504 


14 



700604 

A 

lYBs 

700604 


15 



700724 

A 

ESTa700724 


16 



700521 

A 

SDDF 

*700521 


17 



700722 

A 

CDDF*700722 


16 



700564 

A 

LXBDa700564 


19 



700664 

A 

LYBO 

*700664 


20 





/ 



21 






.globl cint 

22 





/ 



23 





/ CINT CONNECT IN 

24 





/ 



25 

00000 

R 

000000 

A 

CINT 

0 


26 

00001 

R 

000007 

R 


CAL 

IC 

27 

00002 

R 

200227 

R 


LAC 

EV 

28 

00003 

R 

140227 

R 


O^M 

EV 

29 

00004 

R 

740100 

A 


SNA 


30 

00005 

R 

620000 

R 


JNP« 

cint 

31 

00006 

R 

000232 

R 


CAL 

(10) 

32 





/ 



33 

00007 

R 

000011 

A 

IC 

11 


34 

00010 

R 

000227 

R 


EV 


35 

00011 

R 

000014 

A 


14 


36 

00012 

R 

000202 

R 


VPINT 


37 





/ 



38 





/ OINT disconnect 

39 





/ 




cconnect Interrupts 
cdisconkject interrupt^ 



40 

00013 

R 

000000 

A 

DINT 

0 


00014 

R 

000016 

R 


CAl, ID 

42 

00015 

R 

620013 

R 


JMP* OINT 

43 





/ 


44 

00016 

R 

000012 

A 

ID 

12 

45 

00017 

R 

000000 

A 


0 

46 

00020 

R 

000014 

A 


14 

47 

00021 

R 

000202 

R 


VPINt 

48 





/ 


49 





/ CRASE 

ERASE STORAGE SCOPE 

50 





/ 


51 

00022 

R 

000000 

A 

ERASE 

0 

52 

00023 

R 

700724 

A 


EST 

53 

00024 

R 

100174 

R 


JMS wriNT 

54 

00025 

R 

620022 

R 


JMP* erase 

55 





/ 


00 

1 

page 2 

CL 

> 


SRC 





H* 

(jJ 

56 





/ VECTOR 

! -- construct line 


57 





/ 




58 

00026 

R 

000000 

A 

vector 

0 



59 

00027 

R 

120231 

E 


JMS« 

.DA /FE’^CW argument ADDRESSES 


60 

00030 

R 

600035 

R 


JMP 

>5 


61 

00031 

R 

000000 

A 

XI 

0 



62 

00032 

R 

000000 

A 

Y1 

0 



63 

00033 

R 

000000 

A 

X2 

0 



64 

00034 

R 

000000 

A 

Y2 

0 



65 





/ 




66 

00035 

R 

220031 

R 


LAC* 

Xl /DETERM^mE oelta«x s x-incr pola 


67 

00036 

R 

740031 

A 


tca 



68 

00037 

R 

360033 

R 


tad* 

X2 


69 

00040 

R 

722000 

A 


PAL 



70 

00041 

R 

741100 

A 


SPA 



H 

00042 

R 

740031 

A 


TCA 



72 

00043 

R 

040213 

R 


OAC 

DEUX 


73 

00044 

R 

730000 

A 


PLA 



74 

00045 

R 

751100 

A 


SPAJCUA 



75 

00046 

R 

777776 

A 


LAW 

-2 



-14 


00 


76 

00047 

R 

740030 

A 


lAC 



77 

00050 

R 

040215 

R 


DAC 

XINC 


78 





/ 




79 

00051 

R 

220032 

R 


UAC» 

Yl 

/OETERMIwE DELTA^Y « Y«INCR POLA 

80 

00052 

R 

740031 

A 


TCA 



81 

00053 

R 

360034 

R 


TA0« 

Y2 


82 

00054 

R 

722000 

A 


PAL 



83 

00055 

R 

741100 

A 


SPA 



84 

00056 

R 

740031 

A 


TCA 



85 

00057 

R 

040214 

R 


DAC 

oely 


86 

00060 

R 

730000 

A 


PLA 



87 

00061 

R 

751100 

A 


SPAJCLA 



88 

00062 

R 

777776 

A 


LAW 

-2 


09 

00063 

R 

740030 

A 


lAC 



90 

00064 

R 

040216 

R 


OAC 

YINC 


91 





/ 




92 

00065 

R 

200214 

R 


LAC 

DELY 

/IS OELTA«X greater than OR EQUAL 

93 

00066 

R 

740031 

A 


TCA 



94 

00067 

R 

340213 

R 


TAD 

OELX 


95 

00070 

R 

741100 

A 


SPA 


/yEs initialize for horiz large 

96 

00071 

R 

600113 

R 


JMP 

V2 

/NO initialize for vert large 

97 





/ 




98 

00072 

R 

200213 

R 


LAC 

OELX 

/NCsOELX 

99 

00073 

R 

040223 

R 


OAC 

NiC 


100 

00074 

R 

200214 

R 


LAC 

OELY 

/NR*0ELY 

101 

00075 

R 

040226 

R 


DAC 

NR 


102 

00076 

R 

220031 

R 


LAC« 

xl 

/LCC»X 

103 

00077 

R 

040221 

R 


DAC 

LCC 


104 

00100 

R 

220032 

R 


LAC* 

Yl 

/SCC»Y 

105 

00101 

R 

040217 

R 


OAC 

see 


106 

00102 

R 

200233 

R 


LAC 

(LXBD) 

/LCM«LXBD 

107 

00103 

R 

040171 

R 


OAC 

lcm 


108 

00104 

R 

200234 

R 


LAC 

(IYB) 

/SCm«LYB 

109 

00105 

R 

040165 

R 


OAC 

SCM 


110 

00106 

R 

200215 

R 


LAC 

XiNC 

/LCI»XInc 
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111 

00107 

R 

040222 

R 


DAC 

LCl 

112 

00110 

R 

200216 

R 


I.AG 

YINC 

113 

00111 

R 

040220 

R 


OAC 

SCI 

114 

00112 

R 

600133 

R 


JMP 

V3 

115 





/ 



116 

00113 

R 

200214 

R 

V2 

LAC 

DELY 

117 

00114 

R 

040223 

R 


OAC 

nC 

118 

00115 

R 

200213 

R 


LAC 

OELX 

119 

00116 

R 

040226 

R 


OAC 

nR 

120 

00117 

R 

220032 

R 


LAC* 

Yl 

121 

00120 

R 

040221 

R 


DAC 

LCC 

122 

00121 

R 

220031 

R 


LAC* 

Xl 

123 

00122 

R 

040217 

R 


OAC 

see 

124 

00123 

R 

200235 

R 


LAC 

(LYBO) 

125 

00124 

R 

040171 

R 


OAC 

lCm 

126 

00125 

R 

200236 

R 


LAC 

fUXB) 

127 

00126 

R 

040165 

R 


DAC 

^CM 

128 

00127 

R 

200216 

R 


LAC 

YiNC 

129 

00130 

R 

040222 

R 


DAC 

lci 

130 

00131 

R 

200215 

R 


LAC 

XINC 

I3l 

00132 

R 

040220 

R 


DAC 

SCI 

132 





/ 



133 

00133 

R 

200223 

R 

V3 

LAG 

nc 

134 

00134 

R 

040224 

R 


OAC 

nt 

135 

00135 

R 

744020 

A 


RCR 


136 

00136 

R 

040225 

R 


OAC 

nA 

137 





/ 



138 

00137 

R 

220031 

R 


LAC* 

XI 

139 

00140 

R 

700504 

A 


LXR 


140 

00141 

R 

220032 

R 


LAG* 

Yl 

141 

00142 

R 

700664 

A 


LYBO 


1<2 

0014v3 

R 

100174 

R 


JMS 

WFINT 

143 





/ 



144 

00144 

R 

200223 

R 

Pll 

LAC 

NC 

145 

00145 

R 

741200 

A 


SNA 


146 

00146 

R 

620026 

R 


JMP* 

VECTOR 

147 

00147 

R 

723777 

A 


AAC 

>»'l 

148 

00150 

R 

040223 

R 


OAC 

nc 


/SCI*Y|NC 


/NCaDElY 

/NK'DELX 

/UCC«Y 

/scc»x 

/tCM*tYBD 

/scm*lxb 

/UClaylNC 

/SCI«XINC 

/NTsMC 

/NAsNC/2 

/pi^OT Initial point 

/NC50 ? 

/Y^S EXIT 
/NO NC^NC«-1 


-16 


00 


149 





/ 




150 

00151 

R 

200225 

R 


LAC 

ma 

/MAsNIA^NR 

151 

00152 

R 

340226 

R 


TAO 

mR 


152 

00153 

R 

040225 

R 


OAC 

na 


153 





/ 




154 

00154 

R 

200224 

R 


LAC 

NiT 

/N4>NT 

155 

00155 

R 

740031 

A 


TCA 



156 

00156 

R 

340225 

R 


TAP 

NIA 


157 

00157 

R 

741100 

A 


SPA 



158 

00160 

R 

600166 

R 


JMP 

PL2 

/NO -- DO LARGE COUNT MOVEMENT 

159 

00161 

R 

040225 

R 


DAC 

NiA 

/yEs -- na»na«nt « combined move 

160 

00162 

R 

200217 

R 


LAC 

see 

/small count movement 

161 

00163 

R 

340220 

R 


TAP 

SCI 


162 

00164 

R 

040217 

R 


DAC 

sec 


163 

00165 

R 

740040 

A 

SCM 

XX 


/(LYB Or LXB> 

164 





/ 




165 

00166 

R 

200221 

R 

PL2 

LAC 

LCC 

/L^RGE COUNT MOVEMENT 


PAGE 4 

VPi6 


SRC 





166 

00167 

R 

340222 

R 


TAO 

lCI 

167 

00170 

R 

040221 

R 


OAC 

lcc 

168 

00171 

R 

740040 

A 

LCM 

XX 

/(LXBD OP LYBD) 

169 

00172 

R 

100174 

R 


JMS 

wEiNT 

170 





/ 



I7l 

00173 

R 

600144 

R 


JMP 

PLi /TO exit Test 

172 





/ 



173 

00174 

R 

000000 

A 

WEINT 

0 


174 

00175 

R 

000200 

R 


CAL 

WFCP0 

175 

00176 

R 

140227 

R 


D?M 

EV 

176 

00177 

R 

620174 

R 


JHP<* 

wElNT 

177 





/ 



178 

00200 

R 

000020 

A 

wFCP8 

20 


179 

00201 

R 

000227 

R 


EV 


180 





/ 



181 

00202 

R 

000000 

A 

VPINT 

0 


182 

00203 

R 

040230 

R 


OAC 

acbuf 

183 

00204 

R 

440227 

R 


IS2 

EV 

184 

00205 

R 

200237 

R 


LAC 

(401000) 



-17 


00 


J.85 

00206 

R 

705504 

A 



ISA 




186 

00207 

R 

700722 

A 



CDDF 




187 

00210 

R 

200230 

R 



LAC 

acbuf 



188 

00211 

R 

703344 

A 



DBR 




189 

00212 

R 

620202 

R 



JMP« 

VPlNT 



190 






/ 





191 

00213 

R 

000000 

A 


DEtX 

0 


/DLLTA*X 


192 

00214 

R 

000000 

A 


deiy 

0 


/DE^LTA^y 


193 

00215 

R 

000000 

A 


XlNC 

0 


/X increment 

(*1 OR «1) 

194 

00216 

R 

000000 

A 


YINC 

0 


/Y increment 

OR * 1 ) 

195 

00217 

R 

000000 

A 


see 

0 


/small count 

coordinate 

196 

00220 

R 

000000 

A 


SCI 

0 


/small count 

increment 

197 

00221 

R 

000000 

A 


LCC 

0 


/large count 

coordinate 

198 

00222 

R 

000000 

A 


lci 

0 


/L^RGE count 

increment 

199 

00223 

R 

000000 

A 


NC 

0 




?00 

00224 

R 

000000 

A 


NT 

0 




201 

00225 

R 

000000 

A 


NA 

0 




202 

00226 

R 

000000 

A 


nr 

0 




203 

00227 

R 

000000 

A 


EV 

0 




204 

00230 

R 

000000 

A 


ACBUF 

0 




205 






/ 





206 



000000 

A 



.END 





00231 

R 

000231 

E 








00232 

R 

000010 

A 








00233 

R 

700564 

A 








00234 

R 

700604 

A 








00235 

R 

700664 

A 








00236 

R 

700504 

A 








00237 

R 

401000 

A 








SIZE 

:*00240 


NO ERROR 

LINES 






81- 
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ACBUF 

00230 

182 

187 

204# 



CDDF 

700722 

17* 

186 




C|NT 

00000 

21 

25* 

30 



OEIX 

00213 

72 

94 

98 

118 

191* 

DEWY 

0021A 

85 

92 

100 

116 

192* 

DINT 

00013 

21 

40# 

42 



ERASE 

00022 

21 

51* 

54 



EST 

700724 

15* 

52 




EV 

00227 

27 

28 

34 

175 

179 

IC 

00007 

26 

33* 




10 

00016 

41 

44* 




LCC 

00221 

103 

121 

165 

167 

197* 

LCI 

00222 

111 

129 

166 

198* 


LCM 

00171 

107 

125 

168# 



LXB 

700504 

13* 

126 

139 



uxbd 

700564 

18 * 

106 




lyb 

700604 

14* 

108 




lybd 

700664 

19* 

124 

141 



NA 

00225 

136 

150 

152 

156 

159 

NC 

00223 

99 

117 

133 

144 

148 

NR 

00226 

101 

119 

151 

202* 


NT 

00224 

134 

154 

200* 



PLl 

00144 

144* 

171 




Pl,2 

00166 

158 

165* 




see 

00217 

105 

123 

160 

162 

195* 

SCI 

00220 

113 

131 

161 

196* 


SCM 

00165 

109 

127 

163* 



SOOF 

700521 

16* 





VECTOR 

00026 

21 

58# 

146 



VPINT 

00202 

36 

47 

181* 

189 


V2 

00113 

96 

116* 




V3 

00133 

114 

133* 




wrepB 

00200 

174 

178* 




wriNT 

00174 

53 

142 

169 

173* 

176 

XINC 

00215 

77 

110 

130 

193* 


XI 

00031 

61* 

66 

102 

122 

138 

X2 

00033 

63* 

68 




YINC 

00216 

90 

112 

128 

194* 


Y1 

00032 

62* 

79 

104 

120 

140 

Y2 

00034 

64* 

81 




,0A 

00231 

21 

59 





183 203* 


201 * 

199# 



8.5 i/0 HANDLER TASK 


An I/O Handler Task is a Task dedicated to the control of an I/O Device 
Unit. I/O requests to these Tasks are made to Logical Unit Numbers 
and are queued at the requestor's priority. (See section 7.5 for a 
complete description of I/O operations in an I/O Handler Task.) 


A naming convention exists for I/O Handler Tasks (Task Building Name ) , 
requiring the name to be two characters in length followed by four 
periods, respectively (e.g., LP...., PP...., and PR....). 


An example I/O Handler Task used to drive the LP15C Line Printer is 
given at the end of this section. The following paragraphs describe 
the separate sections of the Line Printer Handler, LP.5. 

Line Number * Label Description 

78-104 START This is the Handler initializa- 

tion section required by all I/O 
Handler Tasks. Between lines 
78-84, the Physical Device List 
(PDVL) is scanned for a node for 
this device. If found (line 85) , 
the device Name (line 102) was 
found in the PDVL and a node is 
returned in the AC. If not 
found (line 84) , the Task EXITS 
since no node having the name 
"LP" was found in the PDVL. 

Once the node address is return- 
ed in the AC, the address of the 
Trigger Event Variable in the 
node is calculated and saved 
(line 87) . The interrupt line 
is then CONNECTed (if no connec- 
tion was made the Task EXITS) 
and the address of the Trigger 
Event Variable is placed in the 
Physical Device node (line 92). 
Lines 94 to 96 calculate an ad- 
dress to be used by the Index 
Register later when obtaining 
arguments from the PDVL. The 
Handler then clears the con- 
troller and waits for the 
Trigger Event Variable, TG, to 
be set (WAITFOR TG) . 


* Line Numbers (decimal) along the left hand column of the LP.5 Task 
listing. 
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115-146 


150-173 


174-293 


327-338 


355-380 


PQ The Trigger Event Variable has 

been Triggered. (The CAL 
Service Routine in the Executive 
Triggers the Event Variable 
whenever the Handler has an I/O 
request.) The Trigger is clear- 
ed (line 118) to prevent the 
Handler from being inadvertently 
called when the WAITFOR TG is 
again issued. At line 120 the 
request is de-queued (removed 
from the queue) and if the queue 
is empty, the Handler issues a 
WAITFOR TG which will be set at 
the next I/O request for this 
device. If a node was de-queued, 
the Event Variable and CAL 
Function are removed and tested. 
If the user's Event Variable ad- 
dress (line 128) is zero, the 
handler substitutes an internal 
Event Variable to handle I/O 
completion indications. The CAL 
Function is then tested for 
ATTACH, DETACH, etc When de- 

queuing a request (line 122) , if 
the de -queue was not made (empty 
queue) return from DQRQ is im- 
mediately following the JMS, 
otherwise the return is JMS+2 
(line 125). If the de-queue was 
made, the AC will contain the 
address of the de-queued node. 

If not, the AC contains either 
zero, if the queue was empty, 
or non- zero if the device has 
been ATTACHed. This is useful 
when device handlers are multi- 
unit and the REASSIGN MCR Func- 
tion removes one of its units 
from the LUT. 

ATTACH Routines to ATTACH, DETACH, and 

return Handler Information 
(HINF) . 

PRINT Routines to prepare information 

for and handle the hardware of 
the LP15C. Notice lines 243-246 
declare a Significant Event in- 
dicating that a line has effec- 
tively been printed. 

INT This is the interrupt service 

routine which reads the status 
of the Line Printer (always non- 
zero) and saves it in the Hand- 
ler's Event Variable. A Signif- 
icant Event is then declared and 
return given to the interrupted 
program. 

CCPB CPB ' s used by the Handler. 


8-20 



page 1 


LPt6 SRC 


1 

2 

3 

4 

5 

6 
7 

a 

9 

10 

11 

12 

13 

14 

15 

16 


20 

21 

22 

23 

24 

25 

26 
27 

2a 

29 

30 

31 

32 

33 

34 

35 

36 

37 
3a 
39 


/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 


EDIT #6 


COPYRIGHT 1971, DIGITAU iOUlPMENT CORP,, MAYNARD# MASS, 

RSX PRINTER HANDLER TASK I/aPR/71 M, KREJCI 

THIS handler Task is to drive the lpisc hardware, it is compatable 
WITH normal output FROM FORTRan « MACRO WRITTEN PROGRAMS, OUTPUT IN 
IMAGE mode and output NOT BEGjnNiNG Wnw A »12'# M.4’, tPO*, OR ’2l’ 
CHARACTER IS PRECEDED BY AN UpsPACE (LINEFEED) AND PRINTED DIRECTLY 

FROM the Indicated core, asch output beginning with one of the above 

VERTICAL CONTROL CHARACTERS (E.G,, OUTPUT VIA FORTRAN OTS) IS MOVEn TO 

A buffer within this handler where the header and possibly the leading 
control character (FOR OVERPRinT) is modified and the line (CONSIDERED 
Two LINES BY TmE HARDWARE WHICH TERMINATES LINES AT VERTICAL CONTROL 
CHARACTERS) IS PRINTED, 

there are no Imposed pagl ejects at page bottoms, 

THE following CAL PARAMETER BloQkS ARE USED TO QUEUE REQUESTS FOR 
PRINTER SERVICEI 


CPB 

CPB 

CPB 


CPB 


3600 /handler Information (himf) 

EV 

LUN 

2400 attach printer 

EVA 

l.UN 

2700 PRINT line 

EVA 

lUN 

mode 

LINE 

2500 detach printer 

EVA 

lun 
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40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 


000012 A 
000013 A 
000101 A 
000102 A 
000107 A 


/ 

/ 

/ 

/ 

/ 

/ OF THK 
/ 

/ 

/ 

/ 

/ 

X12»12 

X13*13 

Rl=101 

R2=102 

NAOO«107 


THF REQUFSTOR’S event variable is cleared (ZEROED) WHEN THE REQUEST 
IS QUEUED by the "QUEUE I/O" DIRECTIVE, IF THE REQUEST CAN BE 
PREFORMEOi THE EVENT VARIABLE iS SET TO ONE (+1) UPON COMPLETION, 

IF the request CANNOT BE PERFORMED, THE EVENT VARIABLE IS SET TO ONE 

following negative valueSi 

-5 Data mode (HEADER) disagrees with request mode 
-- illegal request function 

-24 -- LuN HAS been REASSIGNED WHILE REQUEST WAS IN QUEUE 

/AUTO-INCRLMENT rEG i2 
/AUTO"INCrLMENT rEG 13 
/RE-ENTRANT REGISTER ONE 
/RE-ENTRAnT register TWO 
/NODE ADDITION ROUTINE ENTRY POINT 
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56 

000123 

A 

SNAMB123 

/NAME scan routine ENTRY POINT 

57 

000240 

A 

POOL»240 

/LISTHEAO FOR PooL OF EMPTY NODES 

58 

000252 

A 

P0VL*252 

/listhead For physical device list 

59 

000325 

A 

ALADs325 

/ATTACH lun « Device entry point. 

60 

000332 

A 

DLADs332 

/DETACH lun « Device entry point 

61 

000337 

A 

D0RQ*337 

/OE’^OUEUE REQUEST ENTRY POINT 

62 

000010 

A 

D,TG»10 

/POSITION OF trigger EVENT VARIABLE IN POVL NODE 

63 

000034 

A 

WCA = 34 

/WORD count address (NOT USED BY LP CONTROLLER) 

6 4 

000035 

A 

CAAa35 

/CURRENT address REGISTER ADDRESS 

65 

706541 

A 

LPP1S706541 

/PRINT ONE LINE 

66 

706521 

A 

LPPMe706521 

/PRINT multiple line 

67 

706552 

A 

LPRS8706552 

/READ LP STATUS 

68 

706544 

A 

LPEI»706544 

/ENABLE LP INTERRUPTS 

69 

706561 

A 

LPDlr706561 

/DISABLE LF interrupts 

70 

706621 

A 

LPCD»706621 

/CLEAR LP Done flag 

71 

7? 

706641 

A 

LPCS*706641 

/CLEAR LP STATUS AND ERROR FLAGS 

73 

00000 R 002002 

A 

LBF 002002 

/INTERNAL LINE BUFFER HEADER 

74 

00001 R 000000 

A 

000000 

/INITIALIZATION CODE IS USED FOR TEXT BUFFER 



75 





/ 




76 





/ handler initialization 

77 





/ 




78 

00002 

R 

200416 

R 

start 

LAC 

(POVL) 

/SCAN Physical device list for for node 

79 

00003 

R 

060417 

R 


DAC* 

CRl) 

/FOR THIS DEVICE, 

80 

00004 

R 

200420 

R 


LAC 

(HNAM) 


81 

00005 

R 

060421 

R 


DAC* 

(R2) 


82 

00006 

R 

120422 

R 


JMS« 

(SNAM) 

/(PI, R2, R6. XR, 8 AC ARE ALTERED) 

83 








/node Found? 

84 

00007 

R 

000423 

R 


CAL 

(10) 

/NO EXIT 

85 

00010 

R 

040355 

R 


OAC 

POVNA 

/SAVE PDVL node address 

86 

00011 

R 

723010 

A 


AAC 

♦ D.TQ 

/AND trigger event VARIABLE ADDRESS 

87 

00012 

R 

040356 

R 


OAC 

pDVTA 

/trigger Event variable address address, 

88 

00013 

R 

000357 

R 


CAL 

CCPB 

/CONNECT interrupt LINE 

89 

00014 

R 

200347 

R 


LAC 

EV 

/connect Okay? 

90 

00015 

R 

741100 

A 


SPA 



91 

00016 

R 

000423 

R 


CAL 

(10) 

/NO EXIT 

92 

00017 

R 

200424 

R 


lac 

(TG) 

/Yis -* SET trigger EVENT VARIABLE ADDRESS 

93 

00020 

R 

060356 

R 


DAC4 

PDVTA 

/IN physical device node 

94 

00021 

R 

500425 

R 


AND 

(070000)/oCTERMINI ”XR«ADJ” 

95 

00022 

R 

740031 

A 


TCA 



96 

00023 

R 

040342 

R 


DAC 

yADj 


97 





/ 




98 

00024 

R 

706621 

A 


LPCO 


/CI.EAR LP CONTROLLER 

99 

00025 

R 

706641 

A 


LPCS 



100 

00026 

R 

600070 

R 


JMP 

wptgr 

/WAIT FOR TRIGGER 

101 





/ 




102 

00027 

R 

142000 

A 

hnam 

.SIXBT 


/handler Task name 


00030 

R 

000000 

A 





103 





/ 




104 








/end of initialization CODE 

105 





/ 




106 

00031 

R 


A 


.BLOCK 

66*START 

•l 

107 





/ 




108 





/ THE 

above code is over* t t t t t t t t t t t t t t t t t t 

109 





/ tttf fttf tttttfft laved 0V OTS ASCII LINES 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 ♦ t 
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110 





/ 




111 





/ 

WAIT FOR Task 

TO BE 

TRIGGERED (BY 'J/O CAL’ CAL SERVICE ROUTINE) 

112 





/ 

TO SIGNAL THAT A REQUEST HAS BEEN QUEUED, 

113 





/ 




114 

00070 

R 

000373 

R 

WFTGR CAl 

WFTCPB 

/wait For trigger event variable TO BE SET 

115 





/ 




116 





/ 

the Task has 

been TRIGGERED PICK A REQUEST FROM QUEUE (IF ANY) 

117 





/ 




118 

00071 

R 

140354 

R 


OEM 

TG 

/clear trigger 

119 





/ 




120 

00072 

R 

200355 

R 

PO 

LAC 

PDVNA 

/oe»queue a request 

121 

00073 

R 

060417 

R 


OAC** 

(Rl) 


122 

00074 

R 

120426 

R 


JMS^ 

(DORO) 

/(Rl, R2, R4, R5, R6, XR, & AC ARE ALTERED) 

123 








/WAS A request found? 

124 

00075 

R 

600070 

R 


JMP 

WFTGR 

/NO -- wait for trigger 

125 

00076 

R 

040353 

R 


DAC 

RN 

/YES fft* save address OF REQUEST NODE 

126 

00077 

R 

340342 

R 


TAD 

XADJ 

/setup XR TO ACCESS NODE 

127 

00100 

R 

721000 

A 


PAX 



128 

00101 

R 

210006 

A 


LAC 

6,X 

/save Address of requestor’s event variable 

129 

00102 

R 

741200 

A 


SNA 



130 

00103 

R 

200427 

R 


LAC 

(RE) 


131 

00104 

R 

040352 

R 


DAC 

rE 


132 





/ 




133 

00105 

R 

210005 

A 


LAC 

5,X 

/fetch cal function code 

134 

00106 

R 

500430 

R 


AND 

(777) 


135 

00107 

R 

540431 

R 


SAD 

(024) 

/attach request? 

136 

00110 

R 

600123 

R 


JMP 

attach 

/YES attach to a task 

137 

00111 

R 

540432 

R 


SAD 

(025) 

/no detach request? 

138 

00112 

R 

600132 

R 


JMP 

detach 

/YES detach from task 

139 

00113 

R 

540433 

R 


SAD 

(027) 

/NO print request? 

140 

00114 

R 

600143 

R 


JMP 

PRINT 

/YES WRITE RECORD 

141 

00115 

R 

540434 

R 


SAD 

(036) 

/NO handler info request? 

142 

00116 

R 

600141 

R 


JMP 

WlNF 

/YES return info in event variable 

143 

00117 

R 

540430 

R 


SAD 

(777) 

/NO exit (DEASSIGNEO) request? 

144 

00120 

R 

600302 

R 


JMP 

OAEX 

/yes oEaTTACH & EXIT 

145 

00121 

R 

777772 

A 


LAW 

m6 

/nO -- UNImPlIMENTEO function — SET 

146 

00122 

R 

600315 

R 


JMP 

SEV 

/EVENT variable TO -6 

147 





/ 






GZ- 


00 


1A8 





/ attach to a 

TASK 



149 





/ 




150 

00123 

R 

200355 

R 

ATTACH LAC 

pDVNA 

/attach I.UN & DEVICE 


151 

00124 

R 

060417 

R 

OAC* 

(Rl) 



152 

00125 

R 

200353 

R 

LAC 

RN 



153 

00126 

R 

060421 

R 

DAC« 

(R2) 



154 

00127 

R 

120435 

R 

sIMS* 

f alao) 

/(H3, R4, R5, R6, X10, Xll, XR, « AC ARE 

ALTERED) 

155 







/WAS lum attached? 


156 

00130 

R 

600315 

R 

JMP 

SEV 

/NO SE-T REQUESTOR’S EVENT VARIABLE TO 

f24 

157 

00131 

R 

600314 

R 

JMP 

REQCMP 

/Y^s -- request completed 


158 





/ 




159 





/ detach from 

A task 



160 









161 

00132 

R 

200355 

R 

detach lac 

pdvna 

/detach lUn s device 


162 

00133 

R 

060417 

R 

DAC<» 

(Rl) 



163 

00134 

R 

200353 

R 

lac 

RN 



164 

00135 

R 

060421 

R 

DAC<» 

{R2> 
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165 

00136 

R 

120436 

R 


JMS* 

(PLAD) 

/(H3 

, R4, R5, R6, X10, Xll, XR, g AC ARE ALTERED) 
LUM detached? 

166 








/WAS 

167 

00137 

R 

600315 

R 


JHP 

SEV 

/NO 

-- set requestor's event variable to 

168 

00140 

R 

600314 

R 


JMP 

REQCMP 

/yES 

-* request CONPLETED 

169 





/ 




170 





/ RETURN handler INFORMATION 

IN event variable 

171 





/ 




172 

00141 

R 

200437 

R 

HINF 

LAC 

(100011) 



173 

00142 

R 

600315 

R 


JMP 

SEV 



174 





/ 





175 





/ PRINT 

LINE 




176 





/ 




177 

00143 

R 

210010 

A 

PRINT 

LAC 

10iX 

/SET 

header address 

178 

00144 

R 

040350 

R 


DAC 

WXl 



179 

00145 

R 

723002 

A 


AAC 

«2 

/set 

TEXT ADDRESS 

100 

00146 

R 

040351 

R 


OAC 

HX2 


101 

00147 

R 

220350 

R 


LAC<* 

HXl 

/GET 

mode indicator from header 

102 

00150 

R 

500440 

R 


AND 

(003) 
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183 

00151 

R 

550007 

A 



SAD 

7iX /DOES Data mode agree with request mode? 

184 

00152 

R 

600155 

R 



UMP 


185 

00153 

R 

777773 

A 



LAW 

^5 /NO SET event VARIABLE TO «5 

186 

00154 

R 

600315 

R 



JMP 

sev 

187 

00155 

R 

540440 

R 



SAD 

(31 /YES image mode? 

188 

00156 

R 

600174 

R 



JMP 

UBM /YES uNBUFFEDEO MODE 

189 

00157 

R 

220351 

R 



LAC* 

HX2 /no — fetch first character OF TEXT 

190 

00160 

R 

500441 

R 



AND 

(774000>/AND test for LINE TERMINATING CONTROL CHARACTER 

191 

00161 

R 

540442 

R 



SAD 

(050000)/line Feed (i2)? 

192 

00162 

R 

600206 

R 



JMP 

BFM /yES buffered MODE WITH LF IN AC BITS 0^6 

193 

00163 

R 

540443 

R 



SAD 

(060000)/NO form FEED (14)? 

194 

00164 

R 

600206 

R 



JMP 

RFM /yes -- s buffered MODE WITH FF IN AC BITS 0»6 

195 

00165 

R 

540444 

R 



SAD 

{104000)/NO double space (21)? 

196 

00166 

R 

600206 

R 



JMP 

BFM /yES buffered mode WITH DS IN AC SITS 0»6 

197 

00167 

R 

540445 

R 



SAD 

(100000)/NO overprint (20)? 

198 

00170 

R 

741000 

A 



SKP 

/YES BUFFERED MODE WITH CR IN AC BITS 0-6 

199 

00171 

R 

600174 

R 



JMP 

UBM /NO unbuffered MODE 

200 

00172 

R 

200446 

R 



LAO 

(064000) 

201 

00173 

R 

600206 

R 



JMP 

bfm 

202 





/ 




203 





/ 

UN8UFFERE0 OUTPUT MODE UPSpaCE FORMS, AND PRINT A SINGLE 

204 





/ 

LINE 

FROM THE 

REQUESTOR’S BUFfe« IN THE MODE INDICATED BY THE HEADER. 

205 





/ 




206 

00174 

R 

200447 

R 

U8M 

LAC 

(LFl) /p«!nt linefeed line 

207 

00175 

R 

100246 

R 



JMS 

PRNT 

208 

00176 

R 

706541 

A 



LPPI 


209 

00177 

R 

200350 

R 



lao 

HXi /PRINT requested LINE 

210 

00200 

R 

100246 

R 



JMS 

PRNT 

211 

00201 

R 

706541 

A 



LPPI 


212 

00202 

R 

600314 

R 



JMP 

reqcmp /request completed 

213 





/ 




214 

00203 

R 

002003 

A 

lfu 

002003 

/linefeed line 

215 

00204 

R 

000000 

A 



000000 


216 

00205 

R 

000012 

A 



000012 


217 





/ 




218 





/ 

BUFFERED OUTPUT MODE MqvE 5/7 PACKED LINE TO BUFFER IN HANDLER, IF 

219 





/ 

CONTROL CHaR 

IS »20' (Overprint), change to ’i5», and print the two 
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220 





/ LINES 

(CONT 

221 





/ 


222 

00206 

R 

040344 

R 

bfm 

DAC 

223 

00207 

R 

220350 

R 


LAC4 

224 

00210 

R 

640510 

A 


LRS 

225 

00211 

R 

500450 

R 


AND 

226 

00212 

R 

740031 

A 


TCA 

227 

00213 

R 

040346 

R 


OAC 

226 

00214 

R 

723066 

A 


AAC 

229 

00215 

R 

740100 

A 


SMA 

230 

00216 

R 

600221 

R 


JMP 

231 

00217 

R 

777712 

A 


LAW 

232 

00220 

R 

040346 

R 


DAC 

233 

00221 

R 

200350 

R 


LAC 

234 

00222 

R 

740030 

A 


lAC 

235 

00223 

R 

060451 

R 


DAC* 

236 

00224 

R 

200452 

R 


LAC 

237 

00225 

R 

060453 

R 


DAC* 

238 

00226 

R 

220012 

A 


LAC* 

239 

00227 

R 

060013 

A 


DAC* 

240 

00230 

R 

440346 

R 


IS2 

241 

00231 

R 

600226 

R 


JMP 

242 





/ 


243 

00232 

R 

200454 

R 


LAC 

244 

00233 

R 

060352 

R 


DAC* 

245 

00234 

R 

200455 

R 


LAC 

246 

00235 

R 

705504 

A 


ISA 

247 





/ 


248 

00236 

R 

200002 

R 


LAC 

249 

00237 

R 

500456 

R 


AND 

250 

00240 

R 

240344 

R 


XOR 

251 

00241 

R 

040002 

R 


OAC 

250 





/ 


253 

00242 

R 

200457 

R 


LAC 

254 

00243 

R 

100246 

R 


JMS 

255 

00244 

R 

706521 

A 


lppm 

256 





/ 


257 

00245 

R 

600320 

P 


JMP 


char « TEXT) IN ASCII MODE, 

CCBF /SAVE Control char 
HX3. /MOVE text TO INTERNAL BUFFER 
10 

(776) 

CNT 

4.66 


CNT 

HXl 

(X12) 

(LBF*!) 

(Xi3) 

Xl2 

yl3 

CNT 

,'**3 

(♦i) /SET REQUCSTOR’S event VARIABLE TO AND 
re /OlClARE A significant EVENT (LINE HAS BEEN 

(401000)/eFFECTivELY PRINTED) 


LBF+S /change control char to ’15* IF *20* 
(003777) 

CCBF 

lBF*2 

(LBF) /print two lines 
PRNT 


RNTP 


/RETURN REQUEST NODE TO POOL AND PROCESS NEXT REQUEST 
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CO 


258 / 


259 





/ PRNT 

•fip subroutine to 

PRINT A ulNE. THE LINE BUFFER ADDRESS IS 

260 





/ IN AC 

, ANU 

THE lOT TO 

PRINT IS IN THE LOCATION FOLLOWING THE JMS. 

261 





/ 




262 

00246 

R 

000000 

A 

PRNT 

0 



263 

00247 

R 

140301 

R 


D2H 

PRNTEP 

/CLEAR error f^LAG 

264 

00250 

R 

723777 

A 


AAC 

mi 

/Determine & save current address 

265 

00251 

R 

040345 

R 


OAC 

CABF 


266 

00252 

R 

060460 

R 

PRNTl 

DAC* 

(CAA) 

/set current address 

267 

00253 

R 

160461 

R 


D2M* 

(WCA) 

/prevent Word count overflow 

268 

00254 

R 

420246 

R 


XCT» 

PRNT 

/execute print IOTi clear event VARIaBLEi 

269 

00255 

R 

140347 

R 


OZM 

EV 

/enable lP interrupt, and wait for the event 

270 

00256 

R 

706544 

A 


UPEI 


/variable to be set non«hero by the interrupt 

271 

00257 

R 

000375 

R 


CAL 

wPECPB 

/service routine. 

272 





/ 




273 

00260 

R 

200347 

R 


LAC 

EV 

/interrupt has occurred examine printer status 

274 

00261 

R 

500462 

R 


ANO 

(200000) 

/alarm error? 
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275 

00262 

R 

741200 

A 


SNA 



276 

00263 

R 

600277 

R 


ump 

PRNTXT 

/NO exit PRNT SUBROUTINE 

277 

00264 

R 

200301 

R 


LAC 

PRNTEF 

/new errop? 

278 

00265 

R 

740200 

A 


SHA 


/NO delay AND RETRY 

279 

00266 

R 

600273 

R 


UMP 

PRNT2 

280 

00267 

R 

000377 

R 


CAL 

temcpb 

/yes type err message 

281 

00270 

R 

000375 

R 


CAL 

wFECPB 


292 

00271 

R 

200454 

R 


LAC 

(1) 


283 

00272 

R 

040301 

R 


OAC 

PRNTEF 


284 





/ 



/delay 

285 

00273 

R 

000367 

R 

PRNT2 

CAL 

MTCP8 

286 

00274 

R 

000375 

R 


CAL 

wFECPB 


287 

00275 

R 

200345 

R 


LAC 

CABF 

/retry 

288 

00276 

R 

600252 

R 


JMP 

PRNTI 


289 





/ 



/exit PrnT SUBROUTINE 

290 

00277 

R 

440246 

R 

PRNTXT 

ISH 

PRNT 

291 

00300 

R 

620246 

R 


JMP* 

PRNT 


292 





/ 




293 

00301 

R 

000000 

A 

PRNTEF 

0 





294 





/ 



295 





/ EXIT request 

(pROM TASK ”, , .Rea”) 

296 





/ 



297 

00302 

R 

200463 

R 

DAEX lac 

(POOL) 

/return request node to pool 

298 

00303 

R 

060417 

R 

OAC* 

(Rl) 


299 

00304 

R 

200353 

R 

LAC 

PN 


300 

00305 

R 

060421 

R 

OAC* 

(R2) 


301 

00306 

R 

12.0464 

R 

JMS« 

(NADD) 


302 

00307 

R 

706561 

A 

LPDI 


/DISABLE UP interrupts 

303 

00310 

R 

000363 

R 

CAL 

OCPB 

/disconnect interrupt LIME 

304 

00311 

R 

440356 

R 

ISZ 

PDVTA 

/CEEAR assign inhibit flag IN PDVL NOD 

305 

00312 

R 

160356 

R 


PDVTA 


306 

00313 

R 

000423 

R 

CAL 

(10) 

/EXIT 

307 





/ 



306 





/ REQUEST completed -- 

SET REQUESTOR’S EVENT VARIAt^LE TO +1 

309 





/ and pick next 

request 

(IF ANY) from queue. 

310 





/ 



311 

00314 

R 

200454 

R 

REOCMP lac 

( *1) 


312 





/ 



313 

00315 

R 

060352 

R 

SEV OAC« 

RE 

/set REQUESTOR’S EVENT VARIABLE 

314 

00316 

R 

200455 

R 

lac 

(401000) /declare a signipjcamt Event 

315 

00317 

R 

705504 

A 

ISA 



316 





/ 



317 

00320 

R 

200463 

R 

RNTP lac 

(POOL) 

/return request node to pool 

318 

00321 

R 

060417 

R 

DAC<* 

(Rl) 


319 

00322 

R 

200353 

R 

LAC 

RN 


320 

00323 

R 

060421 

R 

DAC« 

(R2) 


321 

00324 

R 

120464 

R 

JMS<» 

(NADD) 


322 





/ 



323 

00325 

R 

600072 

R 

JMP 

PQ 

/PICK Another request (if any) 

324 





/ 



325 





/ INTERRUPT SERVICE ROUTINE 

326 





/ 



327 

00326 

R 

000000 

A 

INT 0 


/interrupt entry point 

328 

00327 

R 

707762 

A 

DBA 


/enter index (Page) mode 

329 

00330 

R 

040343 

R 

DAC 

acbf 

/SAVE Ac 



-30 


00 


PAGE 7 

LP,6 


SRC 




330 

00331 

R 

706552 

A 


lprs 

331 

00332 

R 

040347 

R 


DAC 

332 

00333 

R 

706641 

A 


LPCS 

333 

00334 

R 

706621 

A 


LPCD 

334 

00335 

R 

200455 

R 


LAC 

335 

00336 

R 

705504 

A 


ISA 

336 

00337 

R 

200343 

R 


LAC 

337 

00340 

R 

703344 

A 


DBR 

338 

00341 

R 

620326 

R 


JMP« 

339 





/ 


340 

00342 

R 

000000 

A 

XADJ 

0 

341 

00343 

R 

000000 

A 

ACBF 

0 

342 

00344 

R 

000000 

A 

CCBF 

0 

343 

00345 

R 

000000 

A 

CABF 

0 

344 

00346 

R 

000000 

A 

CNT 

0 

345 

00347 

R 

000000 

A 

EV 

0 

346 

00350 

R 

000000 

A 

HXl 

0 

347 

00351 

R 

000000 

A 

HX2 

0 

348 

00352 

R 

000000 

A 

RE 

0 

349 

00353 

R 

000000 

A 

RN 

0 

350 

00354 

R 

000000 

A 

TG 

0 

351 





/ 


352 

00355 

R 

000000 

A 

POVNA 

0 

353 

00356 

R 

000000 

A 

PDVTA 

0 

354 





/ 


355 

00357 

R 

000011 

A 

CCPB 

11 

356 

00360 

R 

000347 

R 


EV 

357 

00361 

R 

000016 

A 


16 

358 

00362 

R 

000326 

R 


INT 

359 





/ 


360 

00363 

R 

000012 

A 

OCPB 

12 

361 

00364 

R 

000000 

A 


0 

362 

00365 

R 

000016 

A 


16 

363 

00366 

R 

000326 

R 


INT 

364 





/ 


365 

00367 

R 

000013 

A 

MTCPB 

13 

366 

00370 

R 

000347 

R 


EV 

367 

00371 

R 

000012 

A 


12 

368 

00372 

R 

000001 

A 


1 


/RtAO Status and set in event variable 

EV 

/ClEAR STATUSi err FLAG, 5 DONE FLAG 

M01000)/DtCUARE A SIGNIFICANT EVENT 

acbf /restore AC 

/return to interrupted program 

!NT 

/XR ADJUST constant TO SUBTRACT PAGE BITS 
/AC BUFFER 

/CONTROL char BufFER (BITS 0"6> 

/INITIAL current address BUFFER 

/COUNTER 

/EVENT variable 

/HEADER address 

/TEXT ADDRESS 

/ADDRESS QP REQUESTOR’S EVENT VARIABLE 
/ADDRESS QP REQUEST NODE PICKED FROM QUEUE 
/TRIGGER EVENT VARIABLE 

/PHYSICAL device NODE ADDRESS 

/ADDRESS QP ADR oP TRIGGER EV IN PHY DEV NODE 

/CONNECT CPB 


/DISCONNECT CPB 


/MARK TIME CPB 



Te-; 


369 


370 

00373 

371 

00374 

372 


373 

00375 

374 

00376 

375 


376 

00377 

377 

00400 

378 

00401 

379 

00402 

380 

00403 

381 


382 

00404 

00405 

00406 
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00407 

00410 

00411 
00412! 

00413 

00414 
004151 

363 

384 


/ 

R 000020 A WFTCPB 

R 000354 R 

/ 

R 000020 A WFECPB 

R 000347 R 

/ 

R 002700 A TEMCPB 

R 000347 R 

R 000003 A 

R 000002 A 

R 000404 R 

/ 

R 004002 A ERPMES 

R 000000 A 

R 251245 A 


SRC 

R 220230 A 
R 501011 A 
R 647650 A 
R 202450 A 
R 540610 A 
R 544320 A 
R 000000 A 

/ 

000002 R 


20 

TG 


/WAIT FQp Trigger cpb 


20 /WAIT FOR fcVENT VARIABLE CP8 

EV 

2700 /TYEP ERR MESSAGE 

EV 
3 
2 

CRRMeS 

004002J 000000J .ASCII IP NOT REA0Y”<15> 


,ENO start 



-32 


00416 

R 

000252 

A 

•L 

00417 

R 

000101 

A 


00420 

R 

000027 

R 


00421 

R 

000102 

A 


00422 

R 

000123 

A 


00423 

R 

000010 

A 

<»L 

00424 

R 

000354 

R 

•L 

00425 

R 

070000 

A 


00426 

R 

000337 

A 

*L 

00427 

R 

000352 

R 


00430 

R 

000777 

A 


00431 

R 

000024 

A 

«L 

00432 

R 

000025 

A 


00433 

R 

000027 

A 


00434 

R 

000036 

A 


00435 

R 

000325 

A 

*L 

00436 

R 

000332 

A 


00437 

R 

100011 

A 


00440 

R 

000003 

A 


00441 

R 

774000 

A 


00442 

R 

050000 

A 


00443 

R 

060000 

A 

<*L 

00444 

R 

104000 

A 


00445 

R 

100000 

A 

«L 

00446 

R 

064000 

A 

<*L 

00447 

R 

000203 

R 

<»L 

00450 

R 

000776 

A 

*L 

00451 

R 

000012 

A 


00452 

R 

000001 

R 


00453 

R 

000013 

A 


00454 

R 

000001 

A 


00455 

R 

401000 

A 

«L 

00456 

R 

003777 

A 


00457 

R 

000000 

R 


00460 

R 

000035 

A 


00461 

R 

000034 

A 


00462 

R 

200000 

A 


00463 

R 

000240 

A 

«L 

00464 

SI 

R 000107 
ZE=00465 

A 

«L 


NO error lINtS 
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00 
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ACBF 

00343 

329 

336 

341# 




ALAD 

000325 

59« 

154 





attach 

00123 

136 

150# 





8FM 

00206 

192 

194 

196 

201 

222# 


CAA 

000035 

64* 

266 





CA0F 

00345 

265 

287 

343# 




CCBF 

00344 

222 

250 

342# 




CCPB 

00357 

88 

355# 





CNT 

00346 

227 

232 

240 

344# 



DAEX 

00302 

144 

297# 





DCPB 

00363 

303 

360# 





detach 

00132 

138 

161# 





OL.AD 

000332 

60# 

165 





dqrq 

000337 

61# 

122 





OiTG 

000010 

62# 

86 





errmes 

00404 

380 

382# 





EV 

00347 

89 

269 

273 

331 

345# 

356 

HJNF 

00141 

142 

172# 





HNAM 

00027 

80 

102# 





HXl 

00350 

178 

181 

209 

223 

233 

346 

HX2 

00351 

180 

189 

347# 




INT 

00326 

327# 

338 

358 

363 



IBF 

00000 

73# 

236 

248 

251 

253 


in 

00203 

206 

214# 





LPCD 

706621 

70# 

98 

333 




LPCS 

706641 

71# 

99 

332 




LPDI 

706561 

69# 

302 





iPtl 

706544 

68# 

270 





LPPM 

706521 

66# 

255 





LPPi 

706541 

65# 

208 

211 




lprs 

706552 

6 7# 

330 





MTCPB 

00367 

285 

365# 





nado 

000107 

55# 

301 

321 




PDVl 

000252 

58# 

78 





PQVNA 

00355 

85 

120 

150 

161 

352# 


PDVTA 

00356 

87 

93 

304 

305 

353# 


POOL 

000240 

57# 

297 

317 




PQ 

00072 

120# 

323 





PRINT 

00143 

140 

177# 






377 
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00 


f»RNT 

00246 

207 

210 

254 

262# 

268 

290 

PR^TEF 

00301 

263 

277 

283 

293# 



PRNTXT 

00277 

276 

290« 





PRNTl 

00252 

266* 

288 





PRNT2 

00273 

279 

285# 





RE 

00352 

130 

131 

244 

313 

348# 


REQCMP 

00314 

157 

168 

212 

311# 



RN 

00353 

125 

152 

163 

299 

319 

349# 

RNTP 

00320 

257 

317# 





R1 

000101 

53# 

79 

121 

151 

162 

298 

R2 

000102 

54# 

81 

153 

164 

300 

320 

SEV 

00315 

146 

156 

167 

173 

106 

313# 

snam 

000123 

56# 

82 





start 

00002 

78# 

106 

384 




TEMCPB 

00377 

280 

376# 





TC 

00354 

92 

118 

350# 

371 



PAGE 

10 LP 

.6 

CROSS 

REFERENCE 



UBM 

00174 

188 

199 

206# 




WCA 

000034 

63# 

267 





wrccPB 

00375 

271 

281 

286 

373# 



WFTCPB 

00373 

114 

370# 





WFTGR 

00070 

100 

114# 

124 




XADJ 

00342 

96 

126 

340# 




Xl2 

000012 

51# 

235 

238 




X313 

000013 

52# 

237 

239 






8.6 ADDITIONAL INFORMATION 

Tasks Written in FORTRAN: 

The PAUSE statement results in the Task being SUSPENDed. The 

RESUME MCR Function is used to continue after a PAUSE. 

The STOP statement results in a Task EXIT. 

I/O requests to standard I/O Handlers (through LUN's) always wait 
until the I/O request has completed before continuing. 

OTS messages are output on LUN 4, 

OTS-20 is a FORTRAN READ or WRITE failure. 

Tasks Written in MACRO: 

The MACRO Assembler pseudo-op .CBD (Common Block Definition) allows 
the assembly language programmer to declare a COMMON of an indi- 
cated name and size, and to specify a word to be set to its base 
address . 

The .CBD pseudo-op takes a COMMON name and its size as arguments, 
reserves one word of core, and outputs loader codes and parameters 
to direct the Task Builder to set a vector to the first element of 
the indicated COMMON in the reserved word. For example, the state- 
ment 


BASE .CBD ABCD 6 

will provide the base address of COMMON/ABCD/ in the word labeled 
BASE. (This feature will become available under DOS August 71.) 

Normally, 32 LUN's exist; however, this number can be changed by 
reassembling the system. On a cold start image, LUN 1 is assigned 
to DSK, LUN's 2, 3, and 4 are assigned to TT0, and all other LUN's 
are assigned to NONE. 
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APPENDIX A 

SYNTACTICAL DESCRIPTIONS OF !^CR FUNCTIONS 


The following is a description of the MCR Functions provided. The 
syntax is defined in modified Backus Normal Form using the following 
conventions and definitions: 


< > = Angle brackets delimit metalinguistic variables 

" " = Quote marks delimit a. character string 

I = A vertical bar indicates alternation (OR) 

No operator indicates concatenation 
( ) - Parens indicate factoring 

$ = Indicates any number (including zero) of the 

following 

NUL = Indicates the empty set 

<BC> - Break character — blank or comma 

<CR> = Carriage Return 

<AM> = ALTMODE 

<NBC> = Non-break character 

<NTC> = Non-terminal character 

<DV> = Decimal value 


A. ENTER TIME 

SYNTAX = "ETI" $<NBC><BC><TIME> (<BC><DATE> | NUL) <CR> | <AM> 

<TIME> = <HOURS>":"<MINUTES>":"<SECONDS> 

<DATE> = <M0NTH>''/"<DAY>"/"<YEAR> 


B. 

TIME 






SYNTAX = 

"TIM" 

$<NTC> 

<CR> 1 

i <AM> 

C. 

DATE 






SYNTAX = 

"DAT" 

$<NTC> 

<CR> 1 <AM> 

D. 

TASK LIST 






SYNTAX = 

"TAS" 

$<NTC> 

<CR> 1 

1 <AM> 

E. 

PARTITIONS 






SYNTAX = 

"PAR" 

$<NTC> 

<CR> 

1 <AM> 

F. 

COI-IMON BLOCKS 






SYNTAX = 

"COM" 

$<NTC> 

<CR> 

1 <AM> 
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DEVICES AND ASSIGNMENTS 


SYNTAX 

INSTALL 

SYNTAX 

REMOVE 

SYNTAX 

REQUEST 

SYNTAX 

SCHEDULE 

SYNTAX 


RUN 

SYNTAX 


SYNC 

SYNTAX 


"DEV" $<NTC> <CR> <AM> 


"INS" $<NBC><BC><TASK NAME> 

(<BC><DEFAULT PRIORITY> | NUL) <CR> j <AM> 

<DEFAULT PRIORITY> = Decimal value of 1-512 


"REM" $<NTC> <CR>|<AM> 


"REQ" $<NBC><BC><TASK NAME> 

(<BC><RUN PRIORITY> |nUL) <CR> | <AM> 

<RUN PRIORITY> = Decimal value of 1-512 


"SCH" $<NBC><BC><TASK NAME><BC><TIME> 

(<BC>< RE SCHEDULE INTERVAL> j NUL) 

(<BC><RUN PRIORITY>) <CR> | <AM> 

<TIME> = <HOURS>":"<MINUTES>":"<SECONDS> 
<RESCHEDULE INTERVAL> = <DV>("H" "M" "S" "T" ) 
<RUN PRIORITY> = Decimal value of 1-512 


"RUN" $<NBC><BC><TASK NAME ><BC>< SCHEDULE DELTA> 
(<BC><RESCHEDULE INTERVAL> | NULL) 

(<BC><RUN PRIORITY> |NUL) <CR> | <AM> 

<SCHEDULE DELTA> = <DV> ( "H" [ "M" | "S" | "T" ) 
<RESCHEDULE INTERVAL> = <DV> ( "H" | "M" | "S" | "T" ) 
<RUN PRI0RITY> = Decimal value of 1-512 


"SYN" $<NBC><BC><TASK NAMEXBCXSYNC UNIT> 
<SCHEDULE DELTA> (<BCX RESCHEDULE INTERVAL> [ NUL) 
(<BCXRUN PRIORITY> jNUL) <CR> | <AM> 

<SYNC UNIT> = "H" I "M" I "S" 1 "T" 

<SCHEDULE DELTA> = <DV> ( "H" ] "M" | "S" ] "T" ) 
<RESCHEDULE INTERVAL> = <DV> ( "H" | "M" | "S" [ "T" ) 
<RUN PRIORITY> = Decimal value of 1-512 



N. CANCEL 

SYNTAX = "CAN" $<NTC> <CR> j <AM> 

O. RESUME 

SYNTAX = "RES" $<NBC><BC><TASK NAf4E> <CR> [ <AM> 

P. FIX IN CORE 

SYNTAX = "FIX" $<NBC><BC><TASK NAME> <CR> I <AM> 


Q. UNFIX 

SYNTAX = "UNF" $<NBC><BC><TASK NAME> <CR> | <AM> 

R. ENABLE 

SYNTAX = "ENA" $<NBC><BC><TASK NAME> <CR> | <AM> 


S. DISABLE 

SYNTAX = "DIS" $<NBC><BC><TASK NAME> <CR> I <AM> 


T. REASSIGN 

SYNTAX = "REA" $<NBC><BC><LUN><BC><NEW ASSIGNMENT> 
<BC><OLD ASSIGNMENT> <CR> | <AM> 


U . SAVE 


SYNTAX = "SAV" $<NTC> <CR> j <AM> 

V. OPEN REGISTER 

SYNTAX = "OPE" $<NBC><BC><NUMBER> (<BC> "D" (<UNIT> | NUL) | NUL) 
<CR> I <AM> 

<NUMBER> = <SIGN><RADIX><DIGIT>$<DIGIT> 

<SIGN> = "+"|"-"1nUL 
<RADIX> = "0"|"D"1nUL 

<DIGIT> = (j2(|ll2|3i4|5|6|7)|(0|l|2|3|4|5|6|7|8|9) 
default: positive, octal. 

<UNIT> — Disk unit nuinber •" default: zero. 


A- 3 




APPENDIX B 

MACRO EXPANSIONS FOR SYSTEM DIRECTIVES 


/ e:oit #6 
/ 

/ copyright 1971, digital tGUlPHENT CORP.i MAYNArOi HASSi 


/ 


/ RSX- 

I 

15 MACRO 

definitions 8 APR 7l 

H. KREJCI 

f 

/ abreviatioms 

-- UNLESS otherwise , SPECIFIED, 

ALL parameters 

/ 

/ 


EXCEPT ADDRESSES ARE GIVEN 

IN decimal, 

/ 

/ 

RUFF 

CORE BUFFER ADDRESS 


/ 

CL 

interrupt connect LOCATION 


/ 

CTB 

CONTROL table ADDRESS 


/ 

ev 

EVENT variable ADDRESS 


/ 

flnam 

file name (1-6 characters) 


/ 

LN 

interrupt line number (OCTAL) 


/ 

LUN 

logical unit number 


/ 

Ml 

HARK TIME interval (A TICK THRU A DAY) 

/ 

MODE 

DATA MODE indicator 


/ 

MU 

MARK TIME UNITS 


/ 

RA 

RESUMPTION address 


/ 

RI 

RESCHEDULE INTERVAL (0^1 DAY, 

WHERE 0 

/ 


implies No RESCHEDULING) 


/ 

RP 

RUN priority (0-512, WHERE U 

implies 

/ 


default priority) 


/ 

RU 

reschedule units' (H,M,S,T) 


/ 

SO 

SCHEDULE delta (a TICK THRU A 

pay) 

/ 

SH 

SCHEDULE HOURS (0^23) 


/ 

S1?E 

CORE BUFFER Sl2E (OCTAL) 


/ 

SH 

SCHEDULE minutes (0«59) 


/ 

ss 

SCHEDULE SECONDS (0^59) 


/ 

SU 

schedule delta units (H,M,S»T) 

/ 


SYKiCHRONiZATlON UNIT (M,M,S»T) 

/ 

TASNAM 

TASK name (1-6 CHARACTERS) 


/ 

i 

EXT 

FILE name extension (1-3 CHARACTERS) 

/ 

M84 

/HOURS 

indicator 


M53 

/minutes INDICATOR 


Sa? 

/SECONDS INDICATOR 


Tsl 

> 

/TICKS 

Indicator 


,INHa7?5522 /INTERRUPT INHIBIT IQT 


,ENB=705521 /interrupt ENABLE lOT 
> 


/ 

HHS165 

/HRS IN 

SCOM 


HH=164 

/min in 

SCOM 


SSal63 

/SEC IN 

SCOM 


mO»166 

/MON IN 

SCOM 


OAS167 

/day IN 

SCOM 


YRS170 

/YEAR IN SCOM 


SAVE=13l /SAVE 

ENTRY POINT (IN SCOM) 



REST=134 /RESTORE ENTRY POINT (IN SCOM) 
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/ 

/ 

/ 


» I 


3 


» » 


/ 

/ •#»* 
/ 


* t * I J 


/ 

/ 

/ 


t I 


s 


I J 


f 

/ »*«* 
/ 


t 


REQUEST TASNAMC ,RPt ,EV]3 

.DEFIN request , TNiRP#EV 
CAU ,+2 

JMP .*6 

01 

EV*0 

,S1XBT 

0J ,LOC .,+2 

.DEC 

RP*0 

,£NDM 

schedule TASNAM,SH,SH,SSt .RI,RUC»RHC»EVDD] 


.DEFIN schedule, TN, SH, SM, SS fRI pRU I HP iEV 

cal .*2 

UMP .♦IS 

02 

EV*0 

.SIXBT "TN” 

0| .log ,,+2 

.DEC 

SHJ SHI SS 

RI*0 

RU*0 

RP*0 

.ENOH 

RUH TASNAH,SO,SUC ,Rl ,RUC,RPC,EV:! 3 J 

, DEFIN RUN,TN,SO»SU,Rl ,RU»RP»EV 
CAL .+2 

JHP ,*12 

03 

EV*0 

.SIXBT "TN” 

0 J I LOC . . *2 
.DEC 

SDJ SU 
RI*0 
RU*0 
RP + 0 
,£NDM 

SYNC TASNAM,S?,SD,SUi:,RI,RUC,RPC»EV]3 3 

, DEFIN SYNC,TN,S2#SO,SUiRI iRU#RP,EV 

CAL .*2 

JMP .♦IS 

14 

EV’^0 

.SIXBT ”TN" 

01 .LOG ,,♦2 
.DEC 

S2l SOI SU 
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RI+0 
RU + 0 
RP + 0 

.tNpM 

/ 

/ cancel TASNAHC,£V3 

/ 

.DEFIN CANCELiTN.EV 
CAL .+2 

JMP 
04 

f:v*0 

.SIXBT ”TN" 

0J ,LnC .,+2 
• ENDn 

/ 

f suspend 

/ 

,DE.F!N SUSPEND 
CAL (6) 

,ENDM 

/ 

/ »»»* resume TASNAM[iRAL,EV3] 

/ 

.DEFIN resume, TNiRAiEv 
CAL .*2 

J M P I 

07 

EV*0 

, ,5, ; ,S1XBT "TU" 

0J J_OC .,*2 
RA + 0 

,ENDm 

/ 

V mark MI,MU»EV 

/ 

.DEFIN MARK,MI ,MU»EV 

cal .+2 

JMP .*5 

13 

£V 

•DECl MI; My 
.ENqm 

/ •*»« waitfor EV 

f 

.DEFIN WAITFOR»EV 

CAL .+2 

JMP ,+3 

20 

EV 

.ENDm 

/ 

/ «*«« WAIT 
/ 

.DEFIN WAIT 
CAL (5) 

, E N 0 M 
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/ 

/ «««« 
/ 


/ 

/ »»»« 
/ 


/ 

/ 

/ 


/ 

/ 

/ 


/ *»«» 
/ 


/ 

/ •»»« 
/ 


EXIT 

,defin exit 

CAL ( 15 ?) 

, endv? 

connect ln,clEiE:v3 

.off IN CONNECT, LN I Cl. »EV 
CAL ,+? 

JMP ,+5 

11 

FV*0 

LN 

CL 

.ENDM 


DISCONNECT LN|CLC,LV] 


.DEFIN 0ISC0NNECT»LN,CL,FV 

CAL .+? 

JMP ,+S 

12 

EV*0 

LNI 

CL 

,ENOm 

READ LJN, mode, BUFF, S l3?FC ,EV1 

.DEFIN PLAD,LUN,M00E,BUFF,SIJ?E,EV 
CAL .+2 

JMP ,+7 

2600 
EV + 0 

.OECj LUNJ ,OCT 
MODE 

buff 

SI2E 
.end m 

WRITE LUN,MODE,BUFFC: ,EV3 

.DEFIN WRITE, LUN, MODE, BUFF, EV 

CAL .+2 

JMP ,*6 

2700 

EV + 0 

.DECi LUN) ,OCT 

MODE 

buff 

.endm 

DSKAL CTBC,EV3 

.DEFIN DSKAL, CTB,EV 

cal .*2 
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JMP , +5 

1500 
E V*0 
1 

CT3 

.ENOM 

/ 

/ OSKDAL CTBCiEV] 

/ 

.DEFIN OSKQALiCTBiEV 
CAL ,*2 

JMP ,+5 

1600 
£V*0 
1 

CTB 
• EMDm 

/ 

/ DSKPUT CTf3[»EV] 

/ 

, DEFIN DSKPUT, CTBiEV 

CAU 

JMP ,+5 

3100 
EV*0 
1 

CTB 

,Enqm 

/ 

/ «*«# DSKGET CT8[,EV] 

/ 

, DEFIN DSKGET, CTB»EV 

CAL .+2 

JMP ,+5 

3000 
EV + 0 
1 

CTB 

.ENDM 

/ 

/ attach LUNC,EV] 

/ 

.DEFIN attach, LUNiEV 

CAL ,*2 

JMP ,*4 

?400 

EV*0 

,OECJ LUn; .OCT 
.ENOM 

/ 

$ riC f A r>u iit.Mr.rv/i 

r 

/ 

.OEFIN DETACH, LUNiEV 

CAL .+2 

JMP ,+4 

2500 

EV + 0 
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/ 

/ »»«« 

/ 


.I*.? 


/ 

/ «««» 
/ 


* » * I J 


t 

f »««» 

f 


/ 

/ #*«# 
/ 


/ 

/ 


,DECl LUNJ ,OCT 
, ENDH 

SEEK LUN,FENAM,EXTC,EV3 

.DEFIN SEEK,LUN,FUNAK.EXTtEV 

CAL .+2 

JMP .+7 

3200 

EV*0 

,OECJ LUN] .OCT 
.SIXBT »’FLNAM" 

0» lUOC .1*2 
.SIXBT "EXT” 

,ENDm 

enter LUN,FLNAMiEXTC,EV3 

.OEFIN ENTERiLUN.FlnAHiEXT.EV 
CAL ,*2 

JMP ,♦? 

3300 

EV*0 

,.DEC; LUNJ .OCT 
.SIXBT "FLNAM" 

0J .LOC ,.*2 
.SIXBT "EXT” 

.ENDM 

delete LUNfFLNAM,EXTCiEV3 

.DEFIN OELETEiLUN|FLNAM,eXT,EV 

CAL .*2 

JMP ,*7 

3500 

EV*0 

,OECl LUNi .OCT 
.SIXBT "FLNAM" 

05 ,LOC .,*2 
.SIXBT "EXT" 

,ENOm 

CLOSE LUNC.EV] 

, OEFIN CLOSEiLUNfEV 

CAL .*2 

JMP ,*4 

3400 

EV*0 

.DECJ LUNJ ,OCT 

.endm 

HINF LUN.EV 

•OEFIN HINF.LUN.EV 
CAL . *2 

JMP ,*4 
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3600 

EV*0 

.OECI tUNI *OCT 
,ENDM 

/ 


/ 

disable 

TASNAMC.IV3 

/ 

•DEriM 

DISABLEiTNiEV 


cal 

.♦2 


JMP 

,*5 


21 



EV*0 


f 1 * f 1 

.SIXBT 

**TN” 


01 ,LOC 
,ENDM 

.1*2 

t 

f 

enable 

TASNAMC,EV3 

/ 

.OEFIN 

INABLEiTNiEV 


CAL 

.*2 


JMP 

.♦5 


22 



EV*0 


ll•ll 

.SiXiT 



0* ,LOC 
»ENDM 

.1*2 

/ 

/ **»» 

nx 

TASKNAMCiEV] 

/ 

, OEFIN 

FlX.TNiEV 


CAL 

.♦2 


JMP 

.♦5 


15 



EV*0 


• 1 • I i 

.SIXBT 

»TN” 


01 iLOC 
,ENDM 

. » *2 

f 

/ **•« 

UNFIX 

TASNAMC.EV3 

/ 

.OEFIN 

UNFIX, TN.EV 


cal 

.*2 


JMP 

.♦5 


16 

EV*0 



.SIXBT 

«tn*^ 


01 .loc 

.ENDM 

. .*2 

/ 

/ 

declare 


/ 

.OEFIN 

DECLARE 


LAC 

(401000) 


ISA 

,ENOM 






/ 

f time hrs,min,sec 

/ 

,DEF1N time, HRS, min, sec 
, I nh 

LAC« (NH) 

OAC HRS 

LAC« (MM) 

DAC MlN 

LAC« (SS) 

.ENB 

DAC SEC 

.ENOM 

/ 

/ #««« date HRS, MlN, sec, MON, day, year 

/ 

.OEFIN 0 ate. HRS, min, sec, MOn, day, year 
, INH 

tAC* (Hrt) 

OAC HRS 

LAC« (MM) 

DAC MIN 

LAC* (SS) 

QAC SEC 

LAC* (MO) 

DAC MQM 

LAC* (OA) 

DAC day 

LAC* (YR) 

,EN8 

OAC year 

.ENDM 
f 

f »*** iNTEmtRY cl 
/ 

,DEFIN INTENiTRY.Cl 

CL 0 

DBA 

JMS* (SAVE) 

,REPT 20 

0 

NOP 

,ENDM 

/ 

/ **** INTEXIT cl 
/ 

•OEFIN INTEXIT, CL 
LAC (CL) 

JMP* (REST) 

• Enom 

/ 

.end 
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APPENDIX C 

CAL PARAfCTER BLOCKS FOR SYSTEM DIRECTIVES 


A. QUEUE I/O DIRECTIVE 

Word 0 — CAL Function Code (00) in bits 12-17 and 
I/O Function Code in bits 3-11 
Word 1 — Event Variable address 
Word 2 — Logical Unit Number (LUN) 

Word 3 — Unique to I/O Function 
Word 4 — Unique to I/O Function 
Word 5 — Unique to I/O Function 


B. REQUEST DIRECTIVE 

Word 0 — CAL Function Code (01) 
Word 1 — — Event Variable address 
Word 2 — Task name (first half) 
Word 3 — Task name (second half) 
Word 4 — Run priority (0-512) 


C. SCHEDULE DIRECTIVE 

Word 0 — CAL Function Code (02) 

Word 1 — Event Variable address 
Word 2 — Task name (first half) 

Word 3 — Task name (second half) 

Word 4 — Schedule hour (0-23) 

Word 5 — Schedule minute (0-59) 

Word 6 — Schedule second (0-59) 

Word 7 — Reschedule interval (0-one day) 

Word 10 — Interval units (1-tks, 2-secs, 3-mins, 4-hrs) 
Word 11 — Run priority (0-512) 


D. RUN DIRECTIVE 

Word 0 — CAL Function Code (03) 

Word 1 — Event Variable address 

Word 2 — Task name (first half) 

Word 3 — Task name (second half) 

Word 4 — Schedule delta (0-one day) 

Word 5 — Delta units (1-tks, 2-secs, 3-mins, 4-hrs) 

Word 6 — Reschedule interval (0-one day) 

Word 7 — Interval units (1-tks, 2-secs, 3-mins, 4-hrs) 
Word 10 — Run priority (0-512) 


E. SYNC DIRECTIVE 

Word 0 — CAL Function Code (14) 

Word 1 — Event Variable address 
Word 2 — Task name (first half) 

Word 3 — Task name (second half) 

Word 4 — Sync units (1-tks, 2-secs, 3-mins, 4-hrs) 

Word 5 — Schedule delta from synchronization (0-one day) 
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Word 6 — Delta units (1-tks, 2-secs, 3-inins, 4-hrs) 
Word 7 — Reschedule interval (0-one day) 

Word 10 — Interval units (1-tks, 2-secs, 3-mins, 4-hrs) 
Word 11 — Run priority (0-512) 


CANCEL DIRECTIVE 

Word 0 — CAL Function Code (04) 
Word 1 — Event Variable address 
Word 2 — Task name (first half) 
Word 3 — Task name (second half) 


SUSPEND DIRECTIVE 

Word 0 — CAL Function Code (06) 


RESUME DIRECTIVE 

Word 0 — CAL Function Code (07) 
Word 1 — Event Variable address 
Word 2 — Task name (first half) 
Word 3 — Task name (second half) 
Word 4 — Resumption address 


WAIT DIRECTIVE 

Word 0 — CAL Function Code (05) 


MARK DIRECTIVE 

Word 0 — CAL Function Code (13) 

Word 1 — Event Variable address 
Word 2 — Delta time (O-one day) 

Word 3 — Delta units (l-tks, 2-secs, 3-mins, 4-hrs) 


WAITFOR DIRECTIVE 

Word 0 — CAL Function Code (20) 
Word 1 — Event Variable address 


EXIT DIRECTIVE 

Word 0 — CAL Function Code (10) 


CONNECT DIRECTIVE 

Word 0 — CAL Function Code (11) 

Word 1 — Event Variable address 
Word 2 — Interrupt line number 
Word 3 — Interrupt transfer address 



DISCONNECT DIRECTIVE 


Word 0 — CAL Function Code (12) 

Word 1 — Event Variable address 

Word 2 — Interrupt line number 

Word 3 — Current interrupt transfer address 


FIX DIRECTIVE 

Word 0 — CAL Function Code ( 15) 
Word 1 — Event Variable address 
Word 2 — Task name (first half) 
Word 3 — Task name (second half) 


UNFIX DIRECTIVE 

Word 0 — CAL Function Code (16) 
Word 1 — Event Variable address 
Word 2 — Task name (first half) 
Word 3 — Task name (second half) 


DISABLE DIRECTIVE 

Word 0 — CAL Function Code (21) 
Word 1 — Event Variable address 
Word 2 — Task name (first half) 
Word 3 — Task name (second half) 


ENABLE DIRECTIVE 

Word 0 — CAL Function Code (22) 
Word 1 — Event Variable address 
Word 2 — Task name (first half) 
Word 3 — Task name (second half) 




APPENDIX D 

SUFIMARY Cf RETURNED EVENT VARIABLES 


EVENT VARIABLE CONVENTIONS 

The following conventions apply to Event Variables in Tasks by the 
System. 

1, Positive values signal successful completion 

2, Zero indicates a request is still pending 

3, Negative values indicate rejection or unsuccessful 
completion. 


-6 

-7 

-10 

-11 

-12 

-13 

-14 

-15 

-16 

-23 

-24 


-lj2fl 

-Ij2f2 

-103 

-104 

-201 

-202 

-203 

-204 

-205 

-207 

-210 

-301 

-302 

-777 


Illegal header word read from device (data mode in- 
correct or data validity bits improperly set) (DVH) 
Unimplemented or illegal Function (DVH) 

Illegal data mode (DVH) 

File still open (DVH) 

File not open (DVH) 

DECtape error (DVH) 

File not found (DVH) 

Directory full (DVH) 

Medium full (DVH) 

Output word-pair-count or input-buffer-size error (DVH) 
Input word-pair-count error (DVH) 

LUN has been REASSIGNed while an ATTACH or DETACH 
request was in an I/O request queue (DVH) 

Out of range Logical Unit Number (10.) 

Un-assigned Logical Unit Number (10.) 

Non-resident Device Handler (10.) 

Control Table argument error (DVH) 

Task not in system (RQ. , SC., RN., SY., DA., EA. , FX. , 
UF . , CN . ) 

Task is active (RQ., FX.) or not active (RS.) 

CAL not Task issued (SC., RN., SY., MT.) 

Task is DISABLED (RQ., SC., RN., SY. , FX.) 

Task not suspended (RS.) 

Task already Fixed (FX.) or not Fixed (UF.) 

Partition occupied (FX.) 

Line number rejected (Cl., DI.) 

Line is CONNECTed (Cl.) or not CONNECTed (DI.) 

Pool is empty 


DVH 

— 

Device Handler 

10. 

— 

•Qu£;ue 1/0 • Directive 

RQ. 

— 

'REQUEST' Directive 

SC. 

— 

'SCHEDULE' Directive 

RN. 

— 

' RUN ' Directive 

SY. 

— 

' SYNC ' Directive 

CN. 

— 

'CANCEL' Directive 

RS. 

— 

'RESUME' Directive 

Cl. 

— 

'CONNECT' Directive 

DI. 

— 

'DISCONNECT' Directive 
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FX. — 'FIX IN CORE' Directive 
UF. — 'UNFIX' Directive 
DA. — 'DISABLE' Directive 
EA. — 'ENABLE' Directive 
MT. — 'MARK' Directive 
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APPENDIX E 

REGISTERS SAVED DURING "SAVE" AND "RESTORE" OPERATIONS 


Word 0 — AC buffer 
Word 1 — XR buffer 
Word 2 — LR buffer 
Word 3 — MQ buffer 
Word 4 — SC buffer 
Word 5 — R1 buffer 
Word 6 — R2 buffer 
Word 7 — R3 buffer 
Word 10 — R4 buffer 
Word 11 — R5 buffer 
Word 12 — R6 buffer 
Word 13 — XI 0 buffer 
Word 14 — Xll buffer 
Word 15 — X12 buffer 
Word 16 — X13 buffer 
Word 17 — L20 buffer 


(accumulator) 

(index register) 

(limit register) 
(multiplier-quotient register) 
(step counter) 

(absolute location 101) 
(absolute location 102) 
(absolute location 103) 
(absolute location 104) 
(absolute location 105) 
(absolute location 106) 
(autoincrement register 10) 
(autoincrement register 11) 
(autoincrement register 12) 
(autoincrement register 13) 
(location 20 - CAL return) 
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APPENDIX F 


CONVERSION TABLES 


SCALES OF NOTATION 


2"^ IN DECIMAL 


X 


2 ' 


X 


2' 

• 

X 


2' 


0.001 

1.00069 

33874 

62581 

0.01 

1.00695 

55500 

56719 

0.1 

1.07177 

34625 

36293 

0.002 

1.00138 

72557 

11335 

0.02 

1.01395 

94797 

90029 

0.2 

1.14869 

83549 

97035 

0.003 

1.00208 

16050 

79633 

0.03 

1.02101 

21257 

07193 

0.3 

1.23114 

44133 

44916 

0.004 

1.00277 

64359 

01078 

0.04 

1.02811 

38266 

56067 

0.4 

1.31950 

79107 

72894 

0.005 

1.00347 

17485 

09503 

0.05 

1.03526 

49238 

41377 

0.5 

1.41421 

35623 

73095 

0.006 

1.00416 

75432 

38973 

0.06 

1.04246 

57608 

41121 

0.6 

1.51571 

65665 

10398 

0.007 

1.00486 

38204 

23785 

0.07 

1.04971 

66836 

23067 

0.7 

1.62450 

47927 

12471 

0.008 

1.00556 

05803 

98468 

0.08 

1.05701 

80405 

61380 

0.8 

1.74110 

11265 

92248 

0.009 

1.00625 

78234 

97782 

0.09 

1.06437 

01824 

53360 

0.9 

1.86606 

59830 

73615 





10” 

IN OCTAL 





10" 

n 


10-" 



10 


n 


10- 





1 

0 

1.000 

000 

000 

000 

000 

000 

00 




112 

402 

762 

000 

10 

0.000 

000 

000 

006 

676 

337 

66 



12 

1 

0.063 

146 

314 

631 

463 

146 

31 



1 

351 

035 

564 

000 

11 

0.000 

000 

000 

000 

537 

657 

77 



144 

2 

0.005 

075 

341 

217 

270 

243 

66 



16 

432 

451 

210 

000 

12 

0.000 

000 

000 

000 

043 

136 

32 


1 

750 

3 

0.000 

406 

111 

564 

570 

651 

77 



221 

411 

634 

520 

000 

13 

0.000 

000 

000 

000 

003 

411 

35 


23 

420 

4 

0.000 

032 

155 

613 

530 

704 

15 


2 

657 

142 

036 

440 

000 

14 

0.000 

000 

000 

000 

000 

264 

11 


303 

240 

5 

0.000 

002 

476 

132 

610 

706 

64 


34 

327 

724 

461 

500 

000 

15 

0.000 

000 

000 

000 

000 

022 

01 

3 

641 

100 

6 

0.000 

000 

206 

157 

364 

055 

37 


434 

157 

115 

760 

200 

000 

16 

0.000 

000 

000 

000 

000 

001 

63 

46 

113 

200 

7 

0.000 

000 

015 

327 

745 

152 

75 

5 

432 

127 

413 

542 

400 

000 

17 

0.000 

000 

000 

000 

000 

000 

14 

575 

360 

400 

8 

0.000 

000 

001 

257 

143 

561 

06 

67 

405 

553 

164 

731 

000 

000 

18 

0.000 

000 

000 

000 

000 

000 

01 

7 346 

545 

000 

9 

0.000 

000 

000 

104 

560 

276 

41 

















n log^Q 2, n 109 2 10 DECIMAL 

n nlogio2 n logj 10 n nlog|o2 n iog 2 10 


1 0.30102 99957 3.32192 80949 

2 0.60205 99913 6.64385 61898 

3 0.90308 99870 9.96578 42847 

4 1.20411 99827 13.28771 23795 

5 1.50514 99783 16.60964 04744 


6 1.80617 99740 19.93156 85693 

7 2.10720 99696 23.25349 66642 

8 2.40823 99653 26.57542 47591 

9 2.70926 99610 29.89735 28540 

10 3.01029 99566 33.21928 09489 


ADDITION AND MULTIPLICATION TABLES 


Addition 


Multiplication 


Binary Scale 


0+0=0 0X0=0 

0+l = l-f0=l 0X1 = 1X0 = 0 

1 + 1 = 10 1X1 = 1 


Octal Scale 


0 

01 

02 

03 

04 

05 

06 

07 

1 

02 

03 

04 

05 

06 

07 

10 

2 

03 

04 

05 

06 

07 

10 

11 

3 

04 

05 

06 

07 

10 

11 

12 

4 

05 

06 

07 

10 

11 

12 

13 

5 

06 

07 

10 

11 

12 

13 

14 

6 

07 

10 

11 

12 

13 

14 

15 

7 

10 

11 

12 

13 

14 

15 

16 


1 

02 

03 

04 

05 

06 

07 

2 

04 

06 

10 

12 

14 

16 

3 

06 

11 

14 

17 

22 

25 

4 

10 

14 

20 

24 

30 

34 

5 

12 

17 

24 

31 

36 

43 

6 

14 

22 

30 

36 

44 

52 

7 

16 

25 

34 

43 

52 

61 


MATHEMATICAL CONSTANTS IN OCTAL SCALE 


77 = 341037 

552421| 

e = 

2.55760 

521305, 

7 = 

0.44742 

147707 

77-1 = 0.24276 

301556, 

e"' = 

0.27426 

530661, 

In 7 = 

- 0.43127 

233602 

= 1.61337 

611067, 

Ve = 

1.51411 

230704, 

log: 7 = 

- ,0.62573 

030645 

In 77 = 1.11206 

404435, 

logio e = 

0.33626 

754251, 

V2 = 

1.32404 

746320 

log! 77 = 1.51544 

163223, 

log 2 e = 

1.34252 

166245, 

In 2 = 

0.54271 

027760, 

VIO = 3.12305 

407267, 

log, 10 = 

3.24464 

741136, 

In 10 = 

2.23273 

067355 
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POWERS OF TWO 


n 

2 n 


-n 

2 



1 0 1.0 

2 1 0.5 

4 2 0.25 

8 3 0.125 

16 4 0.062 5 

32 5 0.031 25 

64 6 0.015 625 

128 7 0.007 812 5 

256 8 0.003 906 25 

512 9 0.001 953 125 

1 024 10 0.000 976 562 5 

2 048 11 0.000 488 281 25 

4 096 12 0.000 244 140 625 

8 192 13 0.000 122 070 312 5 

16 384 14 0.000 061 035 156 25 

32 768 15 0.000 030 517 578 125 

65 536 16 0.000 015 258 789 062 5 

131 072 17 0.000 007 629 394 531 25 

262 144 18 0.000 003 814 697 265 625 

524 288 19 0.000 001 907 348 632 812 5 

1 048 576 20 0.000 000 953 674 316 406 25 







2 

097 

152 

21 

0.000 

000 

476 

837 

158 

203 

125 






4 

194 

304 

22 

0.000 

000 

238 

418 

579 

101 

562 






8 

388 

608 

23 

0.000 

000 

119 

209 

289 

550 

781 






16 

777 

216 

24 

0.000 

000 

059 

604 

644 

775 

390 






33 

554 

432 

25 

0.000 

000 

029 

802 

322 

387 

695 






67 

108 

864 

26 

0.000 

000 

014 

901 

161 

193 

847 






134 

217 

728 

27 

0.000 

000 

007 

450 

580 

596 

923 






268 

435 

456 

28 

0.000 

000 

003 

725 

290 

298 

461 






536 

870 

912 

29 

0.000 

000 

001 

862 

645 

149 

230 





1 

073 

741 

824 

30 

0.000 

000 

000 

931 

322 

574 

615 





2 

147 

483 

648 

31 

0.000 

000 

000 

465 

661 

287 

307 





4 

294 

967 

296 

32 

0.000 

000 

000 

232 

830 

643 

653 





8 

589 

934 

592 

33 

0.000 

000 

000 

116 

415 

321 

826 





17 

179 

869 

184 

34 

0.000 

000 

000 

058 

207 

660 

913 





34 

359 

738 

368 

35 

0.000 

000 

000 

029 

103 

830 

456 





68 

719 

476 

736 

36 

0.000 

000 

000 

014 

551 

915 

228 





137 

438 

953 

472 

37 

0.000 

000 

000 

007 

275 

957 

614 





274 

877 

906 

944 

38 

0.000 

000 

000 

003 

637 

978 

807 





549 

755 

813 

888 

39 

0.000 

000 

000 

001 

818 

989 

403 




1 

099 

511 

627 

776 

40 

0.000 

000 

000 

000 

909 

494 

701 




2 

199 

023 

255 

552 

41 

0.000 

000 

000 

000 

454 

747 

350 




4 

398 

046 

511 

104 

42 

0.000 

000 

000 

000 

227 

373 

675 




8 

796 

093 

022 

208 

43 

0.000 

000 

000 

000 

113 

686 

837 




17 

592 

186 

044 

416 

44 

0.000 

000 

000 

000 

056 

843 

418 




35 

184 

372 

088 

832 

45 

0.000 

000 

000 

000 

028 

421 

709 




70 

368 

744 

177 

664 

46 

0.000 

000 

000 

000 

014 

210 

854 




140 

737 

488 

355 

328 

47 

0.000 

000 

000 

000 

6o7 

105 

427 




281 

474 

976 

710 

656 

48 

0.000 

000 

000 

000 

003 

552 

713 




562 

949 

953 

421 

312 

49 

0.000 

000 

000 

000 

001 

776 

356 



1 

125 

899 

906 

842 

624 

50 

0.000 

000 

000 

000 

000 

888 

178 



2 

251 

799 

813 

685 

248 

51 

0.000 

000 

000 

000 

000 

444 

089 



4 

503 

599 

627 

370 

496 

52 

0.000 

000 

000 

000 

000 

222 

044 



9 

007 

199 

254 

740 

992 

53 

0.000 

000 

000 

000 

000 

111 

022 



18 

014 

398 

509 

481 

984 

54 

0.000 

000 

000 

000 

000 

055 

511 



36 

028 

797 

018 

963 

968 

55 

0.000 

000 

000 

000 

000 

027 

755 



72 

057 

594 

037 

927 

936 

56 

0.000 

000 

000 

000 

000 

013 

877 



144 

115 

188 

075 

855 

872 

57 

0.000 

000 

000 

000 

000 

006 

938 



288 

230 

376 

151 

711 

744 

58 

0.000 

000 

000 

000 

000 

003 

469 



576 

460 

752 

303 

423 

488 

59 

0.000 

000 

000 

000 

000 

001 

734 


1 

152 

921 

504 

606 

846 

976 

60 

0.000 

000 

000 

000 

000 

000 

867 


2 

305 

843 

009 

213 

693 

952 

61 

0.000 

000 

000 

000 

000 

000 

433 


4 

611 

686 

018 

427 

387 

904 

62 

0.000 

000 

000 

000 

000 

000 

216 


9 

223 

372 

036 

854 

775 

808 

63 

0.000 

000 

000 

000 

000 

000 

108 


18 

446 

744 

073 

709 

551 

616 

64 

0.000 

000 

000 

000 

000 

000 

054 


36 

893 

488 

147 

419 

103 

232 

65 

0.000 

000 

000 

000 

000 

000 

027 


73 

786 

976 

294 

838 

206 

464 

66 

0.000 

000 

000 

000 

000 

000 

013 


147 

573 

952 

589 

676 

412 

928 

67 

0.000 

000 

000 

000 

000 

000 

006 


295 

147 

905 

179 

352 

825 

856 

68 

0.000 

000 

000 

000 

000 

000 

003 


590 

295 

810 

358 

705 

651 

712 

69 

0.000 

000 

000 

000 

000 

000 

001 

1 

180 

591 

620 

717 

411 

303 

424 

70 

0.000 

000 

000 

000 

000 

000 

000 

2 

361 

183 

241 

434 

822 

606 

848 

71 

0.000 

000 

000 

000 

000 

000 

000 

4 

722 

366 

482 

869 

645 

213 

696 

72 

0.000 

000 

000 

000 

000 

000 

000 


5 

25 

625 

312 5 

656 25 

828 125 

914 062 5 

957 031 25 

478 515 625 

739 257 812 5 

869 628 906 25 

934 814 453 125 

467 407 226 562 5 

733 703 613 281 25 

366 851 806 640 625 

183 425 903 320 312 5 

091 712 951 660 156 25 

545 856 475 830 078 125 

772 928 237 915 039 062 5 

886 464 118 957 519 531 25 

443 232 059 478 759 765 625 

721 616 029 739 379 882 812 5 

860 808 014 869 689 941 406 25 

430 404 007 434 844 970 703 125 

715 202 003 717 422 485 351 562 5 

357 601 001 858 711 242 675 781 25 

678 800 500 929 355 621 337 890 625 

839 400 250 464 677 810 668 945 312 5 

419 700 125 232 338 905 334 472 656 25 

209 850 062 616 169 452 667 236 328 125 

604 925 031 308 084 726 333 618 164 062 5 

302 462 515 654 042 363 166 809 082 031 25 

151 231 257 827 021 181 583 404 541 015 625 

575 615 628 913 510 590 791 702 270 5o7 812 5 

787 807 814 456 755 295 395 851 135 253 906 25 

893 903 907 228 377 647 697 925 567 626 953 125 

446 951 953 614 188 823 848 962 783 813 476 562 5 

723 475 976 807 094 411 924 481 391 906 738 281 25 

361 737 988 403 547 205 962 240 695 953 369 140 625 

680 868 994 201 773 602 981 120 347 976 684 570 312 5 

840 434 497 100 886 801 490 560 173 988 342 285 156 25 

420 217 248 550 443 400 745 280 086 994 171 142 578 125 

210 108 624 275 221 700 372 640 043 497 085 571 289 062 5 

105 054 312 137 610 850 186 320 021 748 542 785 644 531 25 

552 527 156 068 805 425 093 160 010 874 271 392 822 265 625 

776 263 578 034 402 712 546 580 005 437 135 696 411 132 812 5 

388 131 789 017 201 356 273 290 002 718 567 848 205 566 406 25 

694 065 894 508 600 678 136 645 001 359 283 924 102 783 203 125 

847 032 947 254 300 339 068 322 500 679 641 962 051 391 601 562 5 

423 516 473 627 150 169 534 161 250 339 820 981 025 695 800 781 25 

211 758 236 813 575 084 767 080 625 169 910 490 512 847 900 390 625 


F-2 



OCTAL-DECIMAL INTEGER CONVERSION TABLE 
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OCTAL-DECIMAL INTEGER CONVERSION TABLE (confinued) 
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1525 

1526 

1527 

2770 

1528 

1529 

1530 

1531 

1532 

1533 

1534 

1535 


2000 

1024 

to 

to 

2777 

1535 

(Octol) 

(Decimal) 


Octal 

Decimal 

^0000 

4096 

20000 

8192 

30000 

12288 

40000 

16384 

50000 

20480 

60000 

24576 

70000 

28672 



0 

1 

2 

3 

4 

5 

6 

7 


0 

1 

2 

3 

4 

5 

6 

7 

3000 

1536 

1537 

1538 

1539 

1540 

1541 

1542 

1543 


3400 

1792 

1793 

1794 

1795 

1796 

1797 

1798 

1799 

3010 

1544 

1545 

1546 

1547 

1548 

1549 

1550 

1551 


3410 

1800 

1801 

1802 

1803 

1804 

1805 

1806 

1807 

3020 

1552 

1553 

1554 

1555 

1556 

1557 

1558 

1559 


3420 

1808 

1809 

1810 

1811 

1812 

1813 

1814 

1815 

3030 

1560 

1561 

1562 

1563 

1564 

1565 

1566 

1567 


3430 

1816 

1817 

1818 

1819 

1820 

1821 

1822 

1823 

3040 

1568 

1569 

1570 

1571 

1572 

1573 

1574 

1575 


3440 

1824 

1825 

1826 

1827 

1828 

1829 

1830 

1831 

3050 

1576 

1577 

1578 

1579 

1580 

1581 

1582 

1583 


345Q 

1832 

1833 

1834 

1835 

1836 

1837 

1838 

1839 

3060 

1584 

1585 

1586 

1587 

1588 

1589 

1590 

1591 


3460 

1840 

1841 

1842 

1843 

1844 

1845 

1846 

1847 

1 3070 

1592 

1593 

1594 

1595 

1596 

1597 

1598 

1599 


3470 

1848 

1849 

1850 

1851 

1852 

1853 

1854 

1855 

3100 

1600 

1601 

1602 

1603 

1604 

1605 

1606 

1607 


3500 

1856 

1857 

1858 

1859 

1860 

1861 

1862 

1863 

3110 

1608 

1609 

1610 

1611 

1612 

1613 

1614 

1615 


3510 

1864 

1865 

1866 

1867 

1868 

1869 

1870 

1871 

3120 

1616 

1617 

1618 

1619 

1620 

1621 

1622 

1623 


3520 

1872 

1873 

1874 

1875 

1876 

1877 

1878 

1879 

3J 30 

1624 

1625 

1626 

1627 

1628 

1629 

1630 

1631 


3530 

1880 

1881 

1882 

1883 

1884 

1885 

1886 

1887 

3140 

1632 

1633 

1634 

1635 

1636 

1637 

1638 

1639 


3540 

1888 

1889 

1890 

1891 

1892 

1893 

1894 

1895 

3150 

1640 

1641 

1642 

1643 

1644 

1645 

1646 

1647 


3550 

1896 

1897 

1898 

1899 

1900 

1901 

1902 

1903 

3160 

1648 

1649 

1650 

1651 

1652 

1653 

16j4 

1655 


3560 

1904 

1905 

1906 

1907 

1908 

1909 

1910 

1911 

3170 

1656 

1657 

1658 

1659 

1660 

1661 

1662 

1663 


3570 

1912 

1913 

1914 

1915 

1916 

1917 

1918 

1919 

3200 

1664 

1665 

1666 

1667 

1668 

1669 

1670 

1671 


3600 

1920 

1921 

1922 

1923 

1924 

1925 

1926 

1927 

3210 

1672 

1673 

1674 

1675 

1676 

1677 

1678 

1679 


3610 

1928 

1929 

1930 

1931 

1932 

1933 

1934 

1935 

3220 

1680 

1681 

1682 

1683 

1684 

1685 

1686 

1687 


3620 

1936 

1937 

1938 

1939 

1940 

1941 

1942 

1943 

3230 

1688 

1689 

1690 

1691 

1692 

1693 

1694 

1695 


3630 

1944 

1945 

1946 

1947 

1948 

1949 

1950 

1951 

3240 

1696 

1697 

1698 

1699 

1700 

1701 

1702 

1703 


3640 

1952 

1953 

1954 

1955 

1956 

1957 

1958 

1959 

3250 

1704 

1705 

1706 

1707 

1708 

1709 

1710 

1711 


3650 

1960 

1961 

1962 

1963 

1964 

1965 

1966 

1967 

3260 

1712 

1713 

1714 

1715 

1716 

1717 

1718 

1719 


3660 

1968 

1969 

1970 

1971 

1972 

1973 

1974 

1975 

3270 

1720 

1721 

1722 

1723 

1724 

1725 

1726 

1727 


3670 

1976 

1977 

1978 

1979 

1980 

1981 

1982 

1983 

3300 

1728 

1729 

1730 

1731 

1732 

1733 

1734 

1735 


3700 

1984 

1985 

1986 

1987 

1988 

1989 

1990 

1991 

3310 

1736 

1737 

1738 

1739 

1740 

1741 

1742 

1743 


3710 

1992 

1993 

1994 

1995 

1996 

1997 

1998 

1999 

3320 

1744 

1745 

1746 

1747 

1748 

1749 

1750 

1751 


3720 

2000 

2001 

2002 

2003 

2004 

2005 

2006 

2007 

3330 

1752 

1753 

1754 

1755 

1756 

1757 

1758 

1759 


3730 

2008 

2009 

2010 

2011 

2012 

2013 

2014 

2015 

3340 

1760 

1761 

1762 

1763 

1764 

1765 

1766 

1767 


3740 

2016 

2017 

2018 

2019 

2020 

2021 

2022 

2023 

3350 

1768 

1769 

1770 

1771 

1772 

1773 

1774 

1775 


3750 

2024 

2025 

2026 

2027 

2028 

2029 

2030 

2031 

3360 

1776 

1777 

1778 

1779 

1780 

1781 

1782 

1783 


3760 

2032 

2033 

2034 

2035 

2036 

2037 

2038 

2039 

3370 

1784 

1785 

1786 

1787 

1788 

1789 

1790 

1791 


3770 

2040 

2041 

2042 

2043 

2044 

2045 

2046 

2047 


3000 1536 

lo to 

3777 2047 

(Octal) (Decimal) 


F-4 



OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 


4000 

iO 

4777 

(Octal) 

Octal 

10000 

20000 

30000 

40000 

50000 

60000 

70000 


5(X)0 

to 

5777 

(Octol) 


?048 

to 


3559 

tOfcimol’ 


Decimal 

4096 

8192 

12288 

16384 

20480 

24576 

28672 


2560 


to 

3071 

(Declmol) 



0 

1 

2 

3 

4 

5 

6 

7 


0 

1 

2 

3 

4 

5 

6 

7 

4000 

2048 

2049 

2050 

2051 

2052 

2053 

2054 

2055 


4400 

2304 

2305 

2306 

2307 

2308 

2309 

2310 

2311 

4010 

2056 

2057 

2058 

2059 

2060 

2061 

2062 

2063 


4410 

2312 

2313 

2314 

2315 

2316 

2317 

2318 

2319 

4020 

2064 

2065 

2066 

2067 

2068 

2069 

2070 

2071 


4420 

2320 

2321 

2322 

2323 

2324 

2325 

2326 

2327 

4030 

2072 

2073 

2074 

2075 

2076 

2077 

2078 

2079 


4430 

2328 

2329 

2330 

2331 

2332 

2333 

2334 

2335 

4040 

2080 

2081 

2082 

2083 

2084 

2085 

2086 

2087 


4440 

2336 

2337 

2338 

2339 

2340 

2341 

2342 

2343 

4050 

2088 

2089 

2090 

2091 

2092 

2093 

2094 

2095 


4450 

2344 

2345 

2346 

2347 

2348 

2349 

2350 

2351 

4060 

2096 

2097 

2098 

2099 

2100 

2101 

2102 

2103 


4460 

2352 

2353 

2354 

2355 

2356 

2357 

2358 

2359 

4070 

2104 

2105 

2106 

2107 

2108 

2109 

2110 

2111 


4470 

2360 

2361 

2362 

2363 

2364 

2365 

2366 

2367 

4100 

2112 

2113 

2114 

2115 

2116 

2117 

2118 

2119 


4500 

2368 

2369 

2370 

2371 

2372 

2373 

2374 

2375 

4110 

2120 

2121 

2122 

2123 

2124 

2125 

2126 

2127 


4510 

2376 

2377 

2378 

2379 

2380 

2381 

2382 

2383 

4120 

2128 

2129 

2130 

2131 

2132 

2133 

2134 

2135 


4520 

2384 

2385 

2386 

2387 

2388 

2389 

2390 

2391 

4130 

2136 

2137 

2138 

2139 

2140 

2141 

2142 

2143 


4530 

2392 

2393 

2394 

2395 

2396 

2397 

2398 

2399 

4140 

2144 

2145 

2146 

2147 

2148 

2149 

2150 

2151 


4540 

2400 

2401 

2402 

2403 

2404 

2405 

2406 

2407 

4150 

2152 

2153 

2154 

2155 

2156 

2157 

2158 

2159 


4550 

2408 

2409 

2410 

2411 

2412 

2413 

2414 

2415 

4160 

2160 

2161 

2162 

2163 

2164 

2165 

2166 

2167 


4560 

2416 

2417 

2418 

2419 

2420 

2421 

2422 

2423 

4170 

2168 

2169 

2170 

2171 

2172 

2173 

2174 

2175 


4570 

2424 

2425 

2426 

2427 

2428 

2429 

2430 

2431 

4200 

2176 

2177 

2178 

2179 

2180 

2181 

2182 

2183 


4600 

2432 

2433 

2434 

2435 

2436 

2437 

2438 

2439 

4210 

2184 

2185 

2186 

2187 

2188 

2189 

2190 

2191 


4610 

2440 

2441 

2442 

2443 

2444 

2445 

2446 

2447 

4220 

2192 

2193 

2194 

2195 

2196 

2197 

2198 

2199 


4620 

2448 

2449 

2450 

2451 

2452 

2453 

2454 

2455 

4230 

2200 

2201 

2202 

2203 

2204 

2205 

2206 

2207 


4630 

2456 

2457 

2458 

2459 

2460 

2461 

2462 24^3 

4240 

2208 

2209 

2210 

2211 

2212 

2213 

2214 

2215 


4640 

2464 

2465 

2466 

2467 

2468 

2469 

2470 

2471 

4250 

2216 

2217 

2218 

2219 

2220 

2221 

2222 

2223 


4650 

2472 

2473 

2474 

2475 

2476 

2477 

2478 

2479 

4260 

2224 

2225 

2226 

2227 

2228 

2229 

2230 

2231 


4660 

2480 

2481 

2482 

2483 

2i84 

2485 

2486 

2487 

.4270 

2232 

2233 

2234 

2235 

2236 

2237 

2238 

2239 


4670 

2488 

2489 

2490 

2491 

2492 

2493 

2494 

2495 

4300 

2240 

2241 

2242 

2243 

2244 

2245 

2246 

2247 


4700 

2496 

2497 

2498 

2499 

2500 

2501 

2502 

2503 

4310 

2248 

2249 

2250 

2251 

2252 

2253 

2254 

2255 


4710 

2504 

2505 

2506 

2507 

2508 

2509 

2510 

2511 

4320 

2256 

2257 

2258 

2259 

2260 

2261 

2262 

2263 


4720 

2512 

2513 

2514 

2515 

2516 

2517 

2518 

2519 

4330 

2264 

2265 

2266 

2267 

2268 

2269 

2270 

2271 


4730 

2520 

2521 

2522 

2523 

2524 

2525 

2526 

2527 

4340 

2272 

2273 

2274 

2275 

2276 

2277 

2278 

2279 


4740 

2528 

2529 

2530 

2531 

2532 

2533 

2534 

2535 

4350 

2260 

2281 

2282 

2283 

2284 

2285, 

2286 

2287 


4750 

2536 

2537 

2538 

2539 

2540 

2541 

2542 

2543 

4360 

2288 

2289 

2290 

2291 

2292 

2293 

2294 

2295 


4760 

2544 

2545 

2546 

2547 

2548 

2549 

2550 

2551 

4370 

2296 

2297 

2298 

2299 

2300 

2301 

2302 

2303 

[477012552 

2553 

2554 

2555 

2556 

2557 

2558 

2559 





















1 

2 

3 

4 

5 

6 

7 


0 

1 

2 

3 

4 

5 

6 

7 

5000 

2560 

2561 

2562 

2563 

2564 

2565 

2566 

2567 


5400 

2816 

2817 

2818 

2819 

2820 

2821 

2822 

2823 

5010 

2568 

2569 

2570 

2571 

2572 

2573 

2574 

2575 


5410 

2824 

2825 

2826 

2827 

2828 

2829 

2830 

2831 

5020 

2576 

2577 

2578 

2579 

2580 

2581 

25T32 

2583 


5420 

2832 

2833 

2834 

2835 

2836 

2837 

2838 

2838 

5030 

2584 

2585 

2586 

2587 

2588 

2589 

2590 

2591 


5430 

2840 

2841 

2842 

2843 

2844 

2845 

2846 

2847 

5040 

2592 

2593 

2594 

2595 

2596 

2597 

2598 

2599 


5440 

2848 

2849 

2850 

2851 

2852 

2853 

2854 

28SS 

5050 

2600 

2601 

2602 

2603 

2604 

2605 

2606 

2607 


5450 

2856 

2857 

2858 

2859 

2860 

2861 

2862 

2863 

5060 

2608 

2609 

2610 

2611 

2612 

2613 

2614 

2615 


5460 

2864 

2865 

2866 

2867 

2868 

2869 

2870- 2871 

5070 

2616 

2617 

2618 

2619 

2620 

2621 

2622 

2623 


5470 

2872 

2873 

2874 

2875 

2876 

2877 

2878 

2879 

5100 

2624 

2625 

2626 

2627 

2628 

2629 

2630 

2631 


5500 

2880 

2881 

2882 

2883 

2884 

2885 

2886 

2887 

5110 

2632 

2633 

2634 

2635 

2636 

2637 

2638 

2639 


5510 

2888 

2889 

2890 

2891 

2892 

2893 

2894 

2895 

5120 

2640 

2641 

2642 

2643 

2644 

2645 

2646 

2647 


5520 

2896 

2897 

2898 

2899 

2900 

2901 

2902 

2903 

5130 

2648 

2649 

2650 

2651 

2652 

2653 

2654 

2655 


5530 

2904 

2905 

-2906 

2907 

2908 

2909 

2910 

2911 

5140 

2656 

2657 

2658 

2659 

2660 

2661 

2662 

2663 


5540 

2912 

2913 

2914 

2915 

2916 

2917 

2918 

2919 

5150 

2664 

2665 

2666 

2667 

2668 

2669 

2670 

2671 


5550 

2920 

2921 

2922 

2923 

2924 

2925 

2926 

2927 

5160 

2672 

2673 

2674 

2675 

2676 

2677 

2678 

2679 


5560 

2928 

2929 

2930 

2931 

2932 

2933 

2934 

2935 

5170 

2680 

2681 

2682 

2683 

2684 

2685 

2686 

2687 


5570 

2936 

2937 

2938 

2939 

2940 

2941 

2942 

2943 

5200 

2688 

2689 

2690 

2691 

2692 

2693 

2694 

2695 


5600 

2944 

2945 

2946 

2947 

2948 

2949 

2950 

2951 

5210 

2696 

2697 

2698 

2699 

2700 

2701 

2702 

2703 


5610 

2952 

2953 

2954 

2955 

2956 

2957 

2958 

2959 

5220 

2704 

2705 

2706 

2707 

2708 

2709 

2710 

2711 


5620 

2960 

2961 

2962 

2963 

2964 

2965 

2966 

2967 

5230 

2712 

2713 

2714 

2715 

2716 

2717 

2718 

2719 


5630 

2968 

2969 

2970 

2971 

2972 

2973 

2974 

2975 

5240 

2720 

2721 

2722 

2723 

2724 

2725 

2726 

2727 


5640 

2976 

2977 

2978 

2979 

2980 

2981 

2982 

2983 

5250 

2728 

2729 

2730 

■2731 

2732 

2733 

2734 

2735 


5650 

2934 

2985 

2986 

2987 

2988 

2989 

2990 

2991 

5260 

2736 

2737 

2738 

2739 

2740 

2741 

2742 

2743 


5660 

2992 

2993 

2994 

2995 

2996 

2997 

2998 

2999 

5270 

2744 

2745 

2746 

2747 

2748 

2749 

2750 

2751 


5670 

3000 

3001 

3002 

3003 

3004 

3005 

3006 

3007 

5300 

2752 

2753 

2754 

2755 

2756 

2757 

2758 

2759 


5700 

3008 

3009 

3010 

3011 

3012 

3013 

3014 

3015 

5310 

2760 

2761 

2762 

2763 

2764 

2765 

2766 

2767 


5710 

3016 

3017 

3018 

3019 

3020 

3021 

3022 

3023 

5320 

2768 

2769 

2770 

2771 

2772 

2773 

2774 

2775 


5720 

3024 

3025 

3026 

3027 

3028 

3029 

3030 

3031 







4 





on***! 



onoc 




gftgo 

5340 

2784 

2785 

2786 

2787 

2788 

2789 

2790 

2791 


5740 

3040 

3041 

3042 

3043 

3044 

3045 

3046 

3047 

5350 

2792 

2793 

2794 

2795 

2796 

2797 

2798 

2799 


5750 

3048 

3049 

3050 

3051 

3052 

3053 

3054 

3055 

5360 

2800 

2801 

2802 

2803 

2804 

2805 

2806 

2807 


5760 

3056 

3057 

3058 

3059 

3060 

3061 

3062 

3063 

5370 

2808 

2809 

2810 

2811 

2812 

2813 

2814 

2815 


5770 

3064 

3065 

3066 

3067 

3068 

3069 

3070 

3071 


F-5 



OCTAL-DECIMAL INTEGER CONVERSION TABLE (continued) 



0 

1 

2 

3 

4 

5 

6 

7 

6000 

3072 

3073 

3074 

3075 

3076 

3077 

3078 

3079 

6010 

3080 

3081 

3082 

3063 

3084 

3085 

3086 

3087 

6020 

3088 

3089 

3090 

3091 

3092 

3093 

3094 

3095 

6030 

3096 

3097 

3098 

3099 

3100 

3101 

3102 

3103 

6040 

3104 

3105 

3106 

3107 

3108 

3109 

3110 

3111 

6050 

3112 

3113 

3114 

3115 

3116 

3117 

3118 

3119 

6060 

3120 

3121 

3122 

3123 

3124 

3125 

3126 

3127 

6070 

3128 

3129 

3130 

3131 

3132 

3133 

3134 

3135 

6100 

3136 

3137 

3138 

3139 

3140 

3141 

3142 

bl43 

6110 

3144 

3145 

3146 

3147 

3148 

3149 

3150 

3151 

6120 

3152 

3153 

3154 

3155 

3156 

3157 

3158 

3159 

6130 

3160 

3161 

3162 

3163 

3164 

3165 

3166 

3167 

6140 

3168 

3169 

3170 

3171 

3172 

3173 

3174 

3175 

6150 

3176 

3177 

3178 

3179 

3180 

3181 

3182 

3183 

6160 

3184 

3185 

3186 

3187 

3188 

3189 

3190 

3191 

6170 

3192 

3193 

3194 

3195 

3196 

3197 

3198 

3199 

6200 

3200 

3201 

3202 

3203 

3204 

3205 

3206 

3207 

^lO 

3208 

3209 

3210 

3211 

3212 

3213 

3214 

3215 

6220 

3216 

3817 

3218 

3219 

3220 

3221 

3222 

3223 

6230 

3224 

3225 

3226 

3227 

3228 

3229 

3230 

3231 

6240 

3232 

3233 

3234 

3235 

3236 

3237 

3238 

3239 

6250 

3240 

3241 

3242 

3243 

3244 

3245 

3246 

3247 

6260 

3248 

3249 

3250 

3251 

3252 

3253 

3254 

3255 

6270 

3256 

3257 

3258 

3259 

3260 

3261 

3262 

3263 

6300 

3264 

3265 

3266 

3267 

3268 

3269 

3270 

3271 

6310 

3272 

3273 

3274 

3275 

3276 

3277 

3278 

3279 

6320 

3280 

3281 

3282 

3283 

3284 

3285 

3286 

3287 

6330 

3288 

3289 

3290 

3291 

3292 

3293 

3294 

3295 

6340 

3296 

3297 

3298 

3299 

3300 

3301 

3302 

3303 

6350 

3304 

3305 

3306 

3307 

3308 

3309 

3310 

3311 

6360 

3312 

3313 

3314 

3315 

3316 

3317 

3318 

3319 

6370 

3320 

3321 

3322 

3323 

3324 

3325 

3326 

3327 


( 

0 

1 

2 

3 

4 

5 

6 

3 

7000 

3584 

3585 

3586 

3587 

3588 

3589 

3590 

3591 

7010 

3592 

3593 

3594 

3595 

3596 

3597 

3598 

3599 

7020 

3600 

3601 

3602 

3603 

3604 

3605 

3606 

3607 

7030 

3608 

3609 

3610 

3611 

3612 

3613 

3614 

3615 

7040 

3616 

3617 

3618 

3619 

3620 

3621 

3622 

3623 

1 7050 

3624 

3525 

3626 

3627 

3628 

3629 

3630 

3631! 

j 7060 

3632 

3633 

3634 

3635 

3636 

3637 

3636 

3639; 

j 7070 

3640 

3641 

3642 

3643 

3644 

3645 

3646 

3647, 

7100 

3648 

3649 

3650 

3651 

3652 

3653 

3654 

3655* 

7110 

3656 

3657 

3658 

3659 

3660 

366! 

3662 

3663 

7120 

3664 

3665 

3666 

3667 

3668 

3669 

3670 

3671 

7130 

3672 

3673 

3674 

3675 

3676 

3677 

3678 

3679 

7140 

3680 

3681 

3682 

3683 

3684 

3685 

3686 

3687 

7150 

3688 

3689 

3690 

3691 

3692 

3693 

3694 

3695 

7160 

3696 

3697 

3698 

3699 

3700 

3701 

3702 

3703 

7170 

3704 

3705 

3706 

3707 

3708 

3709 

3710 

3711 

7200 

3712 

3713 

3714 

3715 

3716 

3717 

3718 

3719 

7210 

3720 

3721 

3722 

3723 

3724 

3725 

3726 

3727 

7220 

3728 

3429 

3730 

3731 

3732 

3733 

3734 

3735 

7230 

3736 

3737 

3738 

3739 

3740 

3741 

3742 

3743 

7240 

3744 

3745 

3746 

3747 

3748 

3749 

3750 

3751 

7250 

3752 

3753 

3754 

3755 

3756 

3757 

3758 

3759 

7260 

3760 

3761 

3762 

3763 

3764 

3765 

3766 

3767 

7270 

3768 

3769 

3770 

3771 

3772 

3773 

3774 

3775 

7300 

3776 

3777 

3778 

3779 

3780 

3781 

3782 

3783 

7310 

3784 

3785 

3786 

3787 

3788 

3789 

3790 

3791 

7320 

3792 

3793 

3794 

3795 

3796 

3797 

3798 

3799 

7330 

3800 

3801 

3802 

3803 

3804 

3805 

3806 

3807 

7340 

3808 

3809 

3810 

3811 

3812 

3813 

3814 

3815 

7350 

3816 

3817 

3818 

3819 

3820 

3821 

3822 

3823 

7360 

3824 

3825 

3826 

3827 

3828 

3829 

3830 

3831 

7370 

3832 

3833 

3834 

3835 

3836 

3837 

3838 

3839 



0 

1 

2 

3 

4 

5 

6 

7 

1 

6400 

3328 

3329 

3330 

3331 

3332 

3333 

3334 

3335 

6410 

3336 

3337 

3338 

3339 

3340 

3341 

3342 

3343 

6420 

3344 

3345 

3346 

3347 

3348 

3349 

3350 

3351 

6430 

3352 

3353 

3354 

3355 

3356 

3357 

3358 

3359 

6440 

3360 

3361 

3362 

3363 

3364 

3365 

3366 

3367 

6450 

3368 

3369 

3370 

3371 

3372 

3373 

3374 

3375 

6460 

3376 

3377 

3378 

3379 

3380 

3381 

3382 

3383 

6470 

3384 

3385 

3386 

3387 

3388 

3389 

3390 

3391 

6500 

3392 

3393 

3394 

3395 

3396 

3397 

3398 

3399 

6510 

3400 

3401 

3402 

3403 

3404 

3405 

3406 

3407 

6520 

3408 

3409 

3410 

3411 

3412 

3413 

3414 

3415 

6530 

3416 

3417 

3418 

3419 

3420 

3421 

3422 

3423 

6540 

3424 

3425 

3426 

3427 

3428 

3429 

3430 

3431 

6550 

3432 

3433 

3434 

3435 

3436 

3437 

3438 

3439 

6560 

3440 

3441 

3442 

3443 

3444 

3445 

3446 

3447 

6570 

3448 

3449 

3450 

3451 

3452 

3453 

3454 

3455 

6600 

3456 

3457 

3458 

3459 

3460 

3461 

3462 

3463 

6610 

3464 

3465 

3466 

3467 

3468 

3469 

3470 

3471 

6620 

3472 

3473 

3474 

3475 

3476 

3477 

3478 

3479 

6630 

3480 

3481 

3482 

3483 

3484 

3485 

3486 

3487 

6640 

3488 

3489 

3490 

3491 

3492 

3493 

3494 

3495 

6650 

3496 

3497 

3498 

3499 

3500 

3501 

3502 

3503 

6660 

3504 

3505 

3506 

3507 

3508 

3509 

3510 

3511 

6670 

3512 

3513 

3514 

3515 

3516 

3517 

3518 

3519 

6700 

3520 

3521 

3522 

3523 

3524 

3525 

3526 

3527 

6710 

3528 

3529 

3530 

3531 

3532 

3533 

3534 

3535 

6720 

3536 

3537 

3538 

3539 

3540 

3541 

3542 

3543 

6730 

3544 

3545 

3546 

3547 

3548 

3549 

3550 

3551 

6740 

3552 

3553 

3554 

3555 

3556 

3557 

3558 

3559 

6750 

3560 

3561 

3562 

3563 

3564 

3565 

3566 

3567 

6760 

3568 

3569 

3570 

3571 

3572 

3573 

3574 

3575 

6770 

3576 

3577 

3578 

3579 

3580 

3581 

3582 

3583 



6000 

to 

6777 

(Octal) 


Octal 

10000 

20000 

30000 

40000 

50000 

60000 

70000 


7000 

to 

7777 

(Ociol) 


F-6 


3072 

to 

3583 

(Dccimol) 


Decimal 

4096 

8192 

12288 

16384 

20480 

24576 

28672 


3584 

to 

4095 

(Decimol) 



OCTAL-DECIMAL FRACTION CONVERSION TABLE 


cx:tal 

DEC. 

OCTAL 

DEC. 

.000 

. 000000 

. 100 

. 125000 

.001 

. 001953 

. 101 

. 126953 

.002 

. d03906 

.102 

. 128906 

.003 

.005859 

.103 

. 130859 

.004 

.007812 

.104 

.132812 

.005 

. 009765 

.105 

. 134765 

.006 

.011718 

.106 

.136718 

.007 

.013671 

. 107 

. 138671 

.010 

.015625 

.110 

. 140625 

.011 

.017578 

.111 

. 142578 

.012 

.019531 

.112 

. 144531 

.013 

.021484 

.113 

. 146484 

.014 

.023437 

.114 

. 148437 

.015 

.025390 

.115 

. 150390 

.016 

.027343 

.116 

. 152343 

.017 

. 029296 

.117 

. 154296 

.020 

,031250 

.120 

. 156250 

.021 

.033203 

.121 

. 158203 

.022 

.035156 

.122 

.160156 

.023 

.037109 

.123 

.162109 

.024 

. 039062 

.124 

. 164062 

.025 

.041015 

.125 

. 166015 

.026 

. 042968 

.126 

. 167968 

.027 

.044921 

.127 

. 169921 

.030 

.046875 

.130 

.171875 

.031 

.048828 

. 131 

.173828 

. 032 

.050781 

. 132 

. 175781 

.033 

. 052734 

.133 

. 177734 

.034 

.054687 

.134 

.179687 

.035 

.056640 

.135 

. 181640 

.036 

.058593 

. 136 

. 183593 

.037 

.060546 

. 137 

. 185546 

.040 

.062500 

. 140 

. 187500 

.041 

,064453 

. 141 

. 189453 

.042 

.066406 

. 142 

. 191406 

.043 

.068359 

. 143 

. 193359 

.044 

.070312 

. 144 

. 195312 

.045 

,072265 

. 145 

. 197265 

.046 

.074218 

.146 

.199218 

.047 

.076171 

.147 

.201171 

.050 

.078125 

. 150 

.203125 

.051 

. 080078 

.151 

. 205078 

.052 

.082031 

.152 

.207031 

.053 

.083984 

.153 

.208984 

.054 

.085937 

.154 

.210937 

.055 

.087890 

.155 

.212890 

.056 

. 089843 

.156 

.214843 

.057 

.091796 

.157 

.216796 

.060 

. 093750 

. 160 

.218750 

.061 

. 095703 

. 161 

.220703 

.062 

. 097656 

. 162 

.222656 

.063 

. 099609 

. 163 

.224609 

.064 

.101562 

. 164 

.226562 

.065 

. 103515 

.165 

.228515 

.066 

. 105468 

.166 

.230468 

.067 

. 107421 

. 167 

. 232421 

.070 

. 109375 

. 170 

,234375 

.071 

. 111328 

.171 

.236328 

.072 

.113281 

. 172 

.238281 

.073 

.115234 

. 173 

.240234 

.074 

.117187 

. 174 

,242187 

.075 

. 119140 

. 175 

.244140 

4 076 

, 121093 

, 176 

. 246093 


.177 .248046 


OCTAL 

DEC. 

CXTTAL 

DEC. 

.200 

. 250000 

.300 

.375000 

.201 

.251053 

.301 

.376953 

.202 

. 25390G 

.302 

.378906 

.203 

. 255859 

.303 

.380859 

.204 

.257812 

,304 

.382812 

.205 

. 259765 

.305 

.384765 

.206 

.261718 

.306 

.386718 

.207 

. 263671 

.307 

.388671 

,210 

. 265625 

.310 

.390625 

.211 

. 267578 

,311 

.392578 

.212 

.269531 

.312 

,394531 

.213 

.271484 

.313 

. 396484 

.214 

. 273437 

.314 

.398437 

.215 

.275390 

.315 

. 400390 

.216 

. 277343 

.316 

.402343 

.217 

.279296 

.317 

.404296 

.220 

.281250 

.320 

. 406250 

.221 

. 283203 

.321 

. 408203 

.222 

. 285156 

.322 

.410156 

.223 

.287109 

.323 

.412109 

.224 

. 289062 

.324 

.414062 

.225 

.291015 

.325 

.416015 

.226 

.292968 

.326 

.417968 

.227 

. 294921 

.327 

.419921 

.230 

. 296875 

.330 

.421875 

.231 

. 298828 

.331 

. 423828 

.232 

.300781 

.332 

.426781 

.233 

.302734 

.333 

. 427734 

.234 

.304687 

.334 

.429687 

.235 

.306640 

.335 

.431640 

.236 

.308593 

.336 

. 433593 

.237 

.310546 

.337 

.435546 

.240 

.312500 

.340 

.437500 

.241 

.314453 

.341 

.439453 

.242 

.316406 

.342 

.441406 

.243 

.318359 

.343 

.443359 

.244 

.320312 

.344 

.445312 

.245 

. 322265 

.345 

.447265 

.246 

.324218 

.346 

.449218 

.247 

.326171 

.347 

.451171 

.250 

.328125 

.350 

.453125 

.251 

. 330078 

.351 

.455078 

.252 

.332031 

.352 

.457031 

.253 

.333984 

.353 

.458984 

.254 

. 335937 

.354 

. 460937 

.255 

. 337890 

.355 

.462890 

.256 

. 339843 

.356 

.464843 

.257 

.341796 

.357 

.466796 

.260 

.343750 

.360 

.468750 

.261 

.345703 

.361 

.470703 

.262 

.347656 

.362 

.472656 

.263 

. 349609 

.363 

.474609 

.264 

.351562 

.364 

.476562 

.265 

.353515 

.365 

.478515 

.266 

.355468 

.366 

.460468 

.267 

.357421 

.367 

.482421 

.270 

.359375 

.370 

.484375 

.271 

.361328 

.371 

.486328 

.272 

.363281 

.372 

.488281 

.273 

.365234 

.373 

.490234 

.274 

.367187 

.374 

.492187 

.275 

.369140 

.375 

.494140 

.276 

.371093 

.376 

.496093 

.277 

. 373046 

,377 

.498046 


F-: 











OCTAL 

DEC. 

OCTAL 

DEC. 

OCTAL 

DEC. 

OCTAL 

DEC. 

.000000 

.000000 

.000100 

.000244 

.000200 

.000488 

.000300 

.000732 

.000001 

.000003 

.000101 

.000247 

. 000201 

.000492 

.000301 

.000736 

.000002 

. 000007 

.000102 

.000251 

.000202 

.000495 

.000302 

.000740 

. 000003 

.000011 

.000103 

.000255 

.000203 

.000499 

.000303 

.000743 

.000004 

.000015 

.000104 

.000259 

.000204 

. 000503 

.000304 

.000747 

. 000005 

.000019 

.000105 

.000263 

.000205 

.000507 

.000305 

.000751 

.000006 

.000022 

.000106 

.000267 

.000206 

.000511 

.000306 

.000755 

.000007 

.000026 

.000107 

. 00027 C 

AAAAAV 
• VWV * V 1 

.000514 

,000307 

.009759 

. 000010 

. 000030 

,000110 

.000274 

.000210 

.000518 

.000310 

.000762 

.000011 

.000034 

.000111 

.000278 

.000211 

.000522 

.000311 

.000766 

.000012 

.000038 

.000112 

.000282 

.000212 

. 000526 

.000312 

.000770 

. 000013 

. 000041 

.000113 

.000286 

.000213 

.000530 

.000313 

.000774 

.000014 

.000045 

.000114 

.000289 

.000214 

. 000534 

.000314 

.000778 

.000015 

.000049 

.000115 

.000293 

.000215 

. 000537 

.000315 

.000782 

.000016 

.000053 

.000116 

.000297 

.000216 

.000541 

.000316 

.000785 

.000017 

. 000057 

.000117 

.000301 

.000217 

.000545 

.000317 

.000789 

.000020 

.000061 

.000120 

.000305 

. 000220 

.000549 

.000320 

.000793 

.000021 

. 000064 

.000121 

.000308 

.000221 

.000553 

.000321 

.000797 

.000022 

.000068 

.000122 

.000312 

.000222 

.000556 

.000322 

.000801 

.000023 

.000072 

.000123 

.000316 

.000223 

. 000560 

.000323 

.000805 

. 000024 

. 000076 

.000124 

.000320 

.000224 

.000564 

.000324 

.000808 

.000025 

. 000080 

.000125 

.000324 

.000225 

. 000568 

.000325 

.000812 

.000026 

. 000083 

.000126 

.000328 

. 000226 

. 000572 

.000326 

.000816 

. 000027 

. 000087 

.000127 

.000331 

.000227 

.000576 

.000327 

.000820 

.000030 

.000091 

.000130 

.000335 

.000230 

.000579 

.000330 

.000823 

. 000031 

. 000095 

.000131 

.000339 

. 000231 

. 000583 

.000331 

.000827 

. 000032 

. 000099 

.000132 

.000343 

.000232 

.000587 

.000332 

.000831 

.000033 

.000102 

.000133 

.000347 

.000233 

.000591 

.000333 

.000835 

.000034 

.000106 

.000134 

.000350 

.000234 

. 000595 

.000334 

.000839 

. 0 U 0035 

.000110 

.000135 

.000354 

.000235 

.000598 

.000335 

.000843 

.000036 

.000114 

.000136 

.000358 

.000236 

.000602 

.000336 

.000846 

.000037 

.000118 

.000137 

.000362 

. 000237 

.000606 

.000337 

.000850 

. 000040 

.000122 

.000140 

.000366 

.000240 

.000610 

.000340 

.000854 

.000041 

.000125 

.000141 

.000370 

.000241 

.000614 

.000341 

.000858 

.000042 

.000129 

.000142 

.000373 

. 000242 

. 000617 

.000342 

. 000862 

. 000043 

. 000133 

.000143 

.000377 

.000243 

.000621 

.000343 

.000865 

. 000044 

. 000137 

.000144 

.000381 

.000244 

.000625 

.000344 

.000869 

. 000045 

. 000141 

.000145 

.000385 

. 000245 

. 000629 

. 000345 

.000873 

. 000046 

.000144 

.000146 

.000389 

.000246 

.000633 

.000346 

.000877 

.000047 

.000148 

.000147 

.000392 

.000247 

.000637 

.000347 

.000881 

.000050 

. 000152 

. 000150 

.000396 

.000250 

. 000640 

.000350 

.000885 

. 000051 

. 000156 

.000151 

.000400 

.000251 

.000644 

.000351 

.000888 

.000052 

. 000160 

.000152 

.000404 

.000252 

.000648 

.000352 

.000892 

.000053 

.000164 

.000153 

.000408 

. 000253 

. 000652 

.000353 

.000896 

. 000054 

.000167 

.000154 

.000411 

.000254 

.000656 

.000354 

.000900 

.000055 

.000171 

.000155 

.000415 

.000255 

.000659 

.000355 

.000904 

.000056 

.000175 

.000156 

.000419 

. 000256 

.000663 

.000356 

.000907 

.000057 

.000179 

.000157 

.000423 

. 000257 

.000667 

.000367 

.000911 

.000060 

.000183 

.000160 

.000427 

.000260 

.000671 

.000360 

.000915 

.000061 

.000186 

.000161 

.000431 

. 000261 

. 000675 

.000361 

.000919 

. 000062 

. 000190 

.000162 

.000434 

.000262 

.000679 

.000362 

.000923 

.000063 

. 000194 

.000163 

.000438 

.000263 

.000682 

.000363 

.000926 

.000064 

.000198 

.000164 

.000442 

.000264 

. 000686 

.000364 

.000930 

. 000065 

. 000202 

.000165 

.000446 

. 000265 

.000690 

.000365 

.000934 

.000066 

. 000205 

.000166 

.000450 

. 000266 

. 000694 

.000366 

.000938 

.000067 

.000209 

.000167 

.000453 

. 000267 

.000698 

. 000367 

. 000942 

. 000070 

.000213 

.000170 

.000457 

. 000270 

.000701 

.000370 

.000946 

.000071 

.000217 

.000171 

.000461 

.000271 

.000705 

. 000371 

.000949 

.000072 

.000221 

.000172 

.000465 

.000272 

. 000709 

.000372 

.000953 

.000073 

. 000225 
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GLOSSARY 


AFT (ATTACH FLAG TABLE) 

A table corresponding to the Logical Unit Table (LUT) with 2 word 
entries for each LUT slot. Whenever a Logical Unit Number (LUN) 
is attached to a Task, the Task name is set in the corresponding 
AFT slot. Whenever a LUN and Device-unit are both attached to a 
Task, the Device attach flag in the Physical Device List points 
to the appropriate AFT slot. 

ATL (ACTIVE TASK LIST) 

A priority ordered list of Active Tasks used to drive the system. 
The ATL is a deque consisting of one node for each Active Task 
in the system. 

CAL INSTRUCTION 


jr^ rur xlciJ_ saw aic j_iiS ux u,C u-L’aii ciocu. uO u u J- v c jTOuuxiitsa 

All System Directives issue CAL instructions to the Executive 
when making their requests. 


CAL PARAMETER BLOCK 


A block consisting of one or more words of contiguous core used 
to store parameters when issuing System Directives. The System 
Directive is implemented as a CAL Instruction with the address of 
the CAL Parameter Block as its operand. 


CLOCK QUEUE 

The Clock Queue is a deque consisting of one node for each item 
to be done at some time in the future. These items are: schedu- 
ling of Tasks (SCHEDULE, RUN, and SYNC Directives), rescheduling 
of Tasks (Clock interrupt service routine) , and setting of Event 
Variables after elapsed time periods (MARK Directive) . The nodes 
are linked in the order in which they come due. 

COMMON BLOCK, INTERNAL 

An area of contiguous core memory within a partition, available 
only to the Task in the partition during its residency. 

COMMON BLOCK, SYSTEM 

An area of contiguous core memory, defined at System Configuration 
time, where data can be stored and referenced by all Tasks. A 
SYSTEM COMMON BLOCK is referenced by using a COMMON name matching 
a SYSTEM COMMON BLOCK name and declaring that COMMON as SYSTEM 
COMMON to the Task Builder. 


CONSOLE TELETYPE 

The control Teletype of the RSX System where MCR Function requests 
may be issued by the operator. 

CONTROL TABLE 

A 3-word table used when requesting or relinquishing disk space 
or when issuing disk GET and PUT Directives. 



CORE RESIDENT TASK 


A Task which has been fixed-in^core. 

DEFAULT PRIORITY 

A priority given to a Task during Task Building or Task Installation 
that is used when a priority is not specified and the Task's ex- 
ecution is requested or scheduled. 

DEQUE 

A double ended queue consisting of a listhead and list elements 
(nodes) , circularly linked by both forward and backward pointers. 
Deques, or link lists, are used, rather than tables, to store 
system information. 

DIRECTIVES 

Instructions to the RSX Executive (implemented with the use of 
CAL Instructions), to perform indicated operations. 

DISK RESIDENT TASK 

A Task which normally resides on the disk and is brought into a 
core partition when requested. 

EVENT VARIABLE 

A word or variable used to determine the status of a Directive. 

The Event Variable is set to indicate successful completion, 
rejection, status, or a request still pending. An Event Variable 
address of zero indicates that no Event Variable is specified. 

EXECUTIVE 

The heart Of the real-time operating system. It coordinates all 
activities in the system including Task scheduling, I/O super- 
vision, resource allocation, and interactive operator communication. 

I/O HANDLER TASK 

A Task in the RSX System which contains an interrupt service routine 
I/O Handler Tasks are requested whenever they are assigned to a 
LUN. 

LISTHEAD 

A two-word core block with forward and backward pointers pointing 
to the next and previous list node or to itself if empty. The 
listhead is a reference point in a circularly linked list. 

LINKED LIST 

A deque consisting of nodes and listhead used to store system 
information. An empty list consists of only a listhead. 

LUN (LOGICAL UNIT NUMBER) 

Logical Unit Numbers are used to represent Logical I/O Device Units 



rather than Physical Units. Each Logical Unit Number is repre^ 
sented by an entry in the Logical Unit Table. 

LUT (LOGICAL UNIT TABLE) 

A block of contiguous core with a one-word entry, or slot, for 
each Logical Unit Number. When a LUN is assigned to a Physical 
Device Unit, the corresponding LUT slot contains the address of 
the appropriate Physical Device List node. 

MCR( MONITOR CONSOLE ROUTINE) 

The MCR allows the user to communicate on-line with the system 
from the console teleprinter. The MCR consists of the Resident 
MCR Task, which accepts user's commands, and the MCR Functions, 
which actually carry out the indicated requests. 

NODES 


The list elements of a deque. All nodes (of dynamic lists) 
consist of the listhead followed by eight words of data (list 
elements) . 

PARTITION 

An area of contiguous core memory, defined at System Configuration 
time, from which Tasks are executed. 

PARTITION BLOCK 

An abnormal node (34 g words) generated by the System Configurator 
to serve three functions. (1) It contains partition description 
information to assure that a Task being installed into the system 
has been built for an existing partition; (2) It provides core 
for an Event Variable and disk (DSKGET) control table necessary 
to load Tasks into partitions; and (3) it provides for saving 
a Task's environment when it is interrupted by the Executive. 

PBDL (PARTITION BLOCKS DESCRIPTION LIST) 

Partition Blocks generated by the System Configurator are linked 
together into a deque called the PBDL. 

PDVL (PHYSICAL DEVICE LIST) 

A deque constructed by the System Configurator used to describe 
the devices and units in the system. When a logical I/O unit 
is assigned to a physical unit, the address of the node describing 
the device and unit is set in a LUT entry corresponding to the LUN. 

POOL (POOL OF EMPTY NODES) 

Empty ten-word nodes for use in any deque. The Pool is generated 
by the System Configurator from core area that has not been 
specified for other use. 

SCDL (SYSTEM COMMON BLOCK DEFINITIONS LIST) 

A deque consisting of nodes which contain a record of the descrip- 
tions of each System COMMON Block. 



SIGNIFICANT EVENT 


An event which results in the scanning of the Active Task List. 

The following events are considered "Significant Events": (1) 

I/O queuing; (2) normal I/O request completion (dependent upon 
I/O Handler Task); (3) A Task request; (4) a scheduled SCHEDULE, 
RUN, or SYNC coming due; (5) a Mark time expiration; (6) a 
Task resumption (RESUME Directive) ; and (7) a Task EXIT. 

STL (SYSTEM TASK LIST) 

A directory of all Tasks in the System. 

SYSTEM CONFIGURATOR 

A Task which allows the user to tailor the RSX System to best 
fit his requirements. 


TKB 

The Task Builder program used to build executable Tasks from 
relocatable binary files. 

TRIGGER EVENT VARIABLE 

An Event Variable referenced within a PDVL node. The Trigger 
Event Variable is used to stimulate a dormant I/O Handler Task. 



HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PD P-8 & PD P-12 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the' Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Progrom Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 
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